快照平面文件标题描述
通过快照平面文件，可以采用最新 LEARN 数据对象进行集成。下方完整列出了支持的对象、其 UI、馈送标题命名约定及、使用描述及数据要求。
因为数据馈送是一个文本文件，因此，所有数据都采用字符串表示。在某些情况下，需要注意特定格式设置和长度。如果字段要求，需提供支持的值。系统会突出显示并注明必填字段。
用户学习对象
学生信息系统 对象：人员
默认插入/更新行为：智能插入或更新
默认删除行为：禁用
Learn 字段
批处理 UID（必填）
必需：是
唯一：是
标题：external_person_key
描述：组织用户的唯一标识符。这个 ID 由机构提供并且不向用户显示。
强烈建议对每个用户来说，密钥数据是永久、不更改的标识符。良好密钥的示例是在用户申请机构时所分配的永久学生 ID。请注意，数据库无法合并不同帐户之间的数据。
最大长度为 64。
数据源密钥（必填）由集成或数据文件提供。
必需：是
唯一：否
Header: data_source_key
描述：用于建立用户元素分组的键。请注意，此密钥可通过集成配置提供，因此无需在文件中提供。
最大长度：256。接受多字节字符。
名字（必填）
必需：是
唯一：否
标题：firstname
描述：用户已被分配名称。
最大长度为 100。接受多字节字符。
姓氏（必填）
必需：是
唯一：否
标题：lastname
描述：用户的姓氏。
最大长度为 100。接受多字节字符。
用户名（必填）
必需：是
唯一：是
标题：user_id
描述：用户名用于登录 Blackboard。用户名必须是唯一的。
最大长度为 50。接受多字节字符。
姓名发音
必填：否
唯一：否
标题：TBC
描述： 用户名的发音拼写或发音指南。
最大长度：1000。接受多字节字符。
密码
必填：否
唯一：否
标题：passwd
描述：登录 Blackboard 时使用的密码。如果数据馈送中未提供密码，则为了安全起见，Learn 会使用 SHA-512 密码自动填充此字段。
最大长度为 32。接受多字节字符。
域名
必填：否
唯一：否
标题：domain_name
描述：用户登录前通知邮件所用的品牌主机名。该值必须是系统配置的其中一个主机名。无效值会被无预警忽略，用户将使用默认主机名值创建。设置为“仅插入”，将忽略更新。（格式如 blackboard.college.edu 或 college.blackboard.com）
最大长度：255
可用
必填：否
唯一：否
标题：available_ind
描述：用户账户在用户界面中是否可用。如果设置为否，则用户帐户将对管理员和教师显示为灰色。用户将无法登录系统。值可以是“Y”（表示是），也可以是“N”（表示否）。
支持的值：“Y”、“N”。
出生日期
必填：否
唯一：否
标题：birthdate
描述：用户的出生日期。
格式：yyyymmdd。
城市
必填：否
唯一：否
标题：城市
描述：与用户地址对应的城市名称。
最大长度为 50。接受多字节字符。
公司
必填：否
唯一：否
标题：公司
描述：用户所属的公司的名称。
最大长度为 100。接受多字节字符。
国家/地区
必填：否
唯一：否
标题：country
描述：与用户地址对应的国家/地区名称。
最大长度为 50。接受多字节字符。
部门
必填：否
唯一：否
标题：department
描述：用户所在部门或子部门的名称。
最大长度为 100。接受多字节字符。
教育程度
必填：否
唯一：否
标题：educ_level
描述：用户获得的最高教育水平。
支持的值：“K-8”、“高中”、“大一”、“大二”、“高三”、“高三”、“研究生院”、“研究生院”
电子邮件
必填：否
唯一：否
标题：email
描述：用户的电子邮件地址。Blackboard 建议不要将 user_email 留空。无电子邮件地址的用户无法发送电子邮件。
最大长度为 100
机构电子邮件
必填：否
唯一：是
标题：inst_email
描述：用户的机构电子邮件地址。inst_email 可以设置为 null。不会向 inst_email 发送电子邮件通信。
最大长度为 254
代词
必填：否
唯一：否
标题：pronouns
描述：这是用户的代词。接受使用逗号作为分隔符的多个代词值。
最大长度为 1000
性别
必填：否
唯一：否
标题：gender
描述：用户的性别。
支持的值：“未披露”、“男性”、“女性”
住宅电话
必填：否
唯一：否
标题：h_phone_1
描述：用户的家庭电话号码。
最大长度为 50。接受多字节字符。
住宅电话 (次要)
必填：否
唯一：否
标题：h_phone_2
描述：与用户关联的额外家庭电话号码。
最大长度为 50。接受多字节字符。
职位
必填：否
唯一：否
标题：job_title
描述：用户的相关职务名称。
最大长度为 100。接受多字节字符。
中间名
必填：否
唯一：否
标题：middlename
描述：用户将提供中间名。
最大长度为 100。接受多字节字符。
手机
必填：否
唯一：否
标题：m_phone
描述：用户的移动电话或呼机号码。
最大长度为 50。接受多字节字符。
曾用名
必填：否
唯一：否
标题：othername
描述：这是用户的备用首选姓名。
最大长度：100。
密码加密类型
必填：否
唯一：否
标头：pwencryptiontype
描述：该字段确定用于对数据库密码进行加密的加密类型。
支持的值为：MD5、SSHA。
主要机构角色
必填：否
唯一：否
标题：institution_role
描述：用户的主要机构角色，决定用户对门户模块及其他项目的视图。
请参阅系统管理员面板中的“管理机构角色”，获取系统中有效机构角色的列表。
替换批处理 Uid
必填：否
唯一：是
标题：new_external_person_key
描述：该字段仅在用户 EXTERNAL_PERSON_KEY 发生极少数变化时使用。
最大长度为 64。接受多字节字符。
替换数据源批处理 Uid
必填：否
唯一：否
描述：新密钥用于建立用户元素的组。使用指定替换数据源密钥指定的小组替换用于关联数据的现有数据源。注意：替换数据源批处理 UID 的 UI 映射字段是“script.flatfile.UserReplacementDataSourceBatchUid”
行状态
必填：否
唯一：否
标题：row_status
说明：将记录的值设置为以下值之一：启用：对记录的正常访问。已禁用：记录在 UI 的某些区域可见，但可能无法更改或访问。已删除：计划删除记录。
支持的值：“enabled”、“disabled”、“deleted”
最大长度为 64。接受多字节字符。
州/省
必填：否
唯一：否
标头：状态
描述：与用户地址对应的州或省名称。
最大长度为 50。接受多字节字符。
街道 1
必填：否
唯一：否
标题：street_1
描述：用户地址的第一行。
最大长度为 100。接受多字节字符。
街道 2
必填：否
唯一：否
标题：street_2
描述：用户地址的第 2 行。
最大长度为 100。接受多字节字符。
学生 ID
必填：否
唯一：否
标题：student_id
描述：通用标识符字段。这是一个仅显示字段。
最大长度为 100。接受多字节字符。
后缀
必填：否
唯一：否
标题：Suffix
描述：用户名称后缀。
最大长度为 100。接受多字节字符。
系统角色
必填：否
唯一：否
标题：system_role
描述：用户的管理员角色，描述其系统管理权限的级别。角色“无”不提供任何与自身关联的系统管理或课程创建权限，是最经常分配的角色。
系统接受以下字符串：
用户管理员：“account_admin”、“accountadmin” 或 “user_admin” 系统支持：“system_support”或“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 对象：课程/组织
学生信息系统 对象：课程或组织
默认插入/更新行为：智能插入或更新
默认删除行为：禁用
批处理 UID（必填）
必需：是
唯一：是
标题：external_person_key
描述：组织用户的唯一标识符。这个 ID 由机构提供并且不向用户显示。
最大长度为 64。
课程 ID 或组织 ID（必填）
必需：是
唯一：是
标题：course_id 或 organization_id
描述：机构用来唯一标识课程或组织的简称（例如，math101_F99 或 ChessClub）不得使用以下字符：空格 （ ） & / ' +
最大长度为 100。必须是唯一的，且不可更改。
课程名称或组织名称（必填）
必需：是
唯一：否
标题：course_name/organization_name
说明：课程或组织的完整名称。此名称用于显示。
最大长度为 255。接受多字节字符。
数据源密钥（必填）由集成或数据文件提供。
必需：是
唯一：否
Header: data_source_key
描述：用于建立用户元素分组的键。请注意，此密钥可通过集成配置提供，因此无需在文件中提供。
最大长度：256。接受多字节字符。
名字（必填）
必填：否
唯一：否
标题：TBC
描述： 用户名的发音拼写或发音指南。
最大长度：1000。接受多字节字符。
密码
必填：否
唯一：否
标题：passwd
描述：登录 Blackboard 时使用的密码。如果数据馈送中未提供密码，则为了安全起见，Learn 会使用 SHA-512 密码自动填充此字段。
最大长度为 32。接受多字节字符。
域名
必填：否
唯一：否
标题：domain_name
描述：用户登录前通知邮件所用的品牌主机名。该值必须是系统配置的其中一个主机名。无效值会被无预警忽略，用户将使用默认主机名值创建。设置为“仅插入”，将忽略更新。（格式如 blackboard.college.edu 或 college.blackboard.com）
最大长度：255
hasDescriptionPage
必填：否
唯一：否
标题：desc_page_ind
描述：当前不支持该字段。集成不得使用此字段。
numDaysOfUse
必填：否
唯一：否
标题：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”。
出生日期
必填：否
唯一：否
标题：birthdate
描述：用户的出生日期。
格式：yyyymmdd。
城市
必填：否
唯一：否
标题：城市
描述：与用户地址对应的城市名称。
最大长度为 50。接受多字节字符。
公司
必填：否
唯一：否
标题：公司
描述：用户所属的公司的名称。
最大长度为 100。接受多字节字符。
连续式：“C”=课程始终可访问。
范围：“R”=课程可在一START_DATE到END_DATE之间的几天内访问。要使课程从特定日期开始或在特定日期之前可供访问，可以相应地将结束日期或开始日期留为空白。
持续时间：“D”= 注册后 N 天
学期：“T”=学期口述（相关学期的持续时间控制本课程的持续时间）
国家/地区
教学进度
必填：否
唯一：否
标题：country
描述：与用户地址对应的国家/地区名称。
最大长度为 50。接受多字节字符。
部门
必填：否
唯一：否
标题：department
描述：用户所在部门或子部门的名称。
最大长度为 100。接受多字节字符。
教育程度
必填：否
唯一：否
标题：educ_level
描述：用户获得的最高教育水平。
支持的值：“K-8”、“高中”、“大一”、“大二”、“高三”、“高三”、“研究生院”、“研究生院”
电子邮件
必填：否
唯一：否
标题：email
描述：用户的电子邮件地址。Blackboard 建议不要将 user_email 留空。无电子邮件地址的用户无法发送电子邮件。
最大长度为 100
注册结束日期
必填：否
唯一：否
标题：enroll_end
说明：不再提供学生注册日期。
格式：yyyymmdd
注册起始日期
必填：否
唯一：否
标题：enroll_start
说明：注册开始日期。
格式：yyyymmdd
注册类型
必填：否
唯一：否
标题：enroll_option
说明：确定注册方法。
支持的 value：“instructor”、“self”或“email”。
费用
必填：否
唯一：否
标题：成本
说明：与此课程或组织相关的费用。
数字 ，最多 11 个字符，包含 2 位小数。例如，1500.00
机构电子邮件
必填：否
唯一：否
标题：institution_name
描述：组织名称。
最大长度为 255。接受多字节字符。
语言包
必填：否
唯一：否
标题：位置
描述：首选语言包的标识符。该值可表示为 xx_XX，例如，法语语言包可用 fr_FR 表示
最大长度为 20。
已锁定
必填：否
唯一：否
页首：lockout_ind
说明：指示是否限制对课程或组织的访问。如果设置为“Y”，将根据 END_DATE 和 START_DATE 限制对课程或组织的访问。
支持的值：“Y”、“N”
最大磁盘使用量 (软性限制)
必填：否
唯一：否
标题：soft_limit
描述：课程配额有软限制。当课程文件夹存储达到指定的软限制 (soft limit) 且课程配额生效时，此设置会触发警告邮件。
数字。例如：10MB相当于10485760字节。
主要关联批处理 Uid
必填：否
唯一：是
标题：inst_email
描述：用户的机构电子邮件地址。inst_email 可以设置为 null。不会向 inst_email 发送电子邮件通信。
最大长度为 254
代词
course_id
course_name
external_association_key
primary_external_node_key
主要节点批处理 Uid
必填：否
唯一：否
标题：pronouns
描述：这是用户的代词。接受使用逗号作为分隔符的多个代词值。
最大长度为 1000
性别
必填：否
唯一：否
标题：gender
描述：用户的性别。
最大长度：100。
替换批处理 Uid
必填：否
唯一：是
标题：new_external_person_key
描述：该字段仅在用户 EXTERNAL_PERSON_KEY 发生极少数变化时使用。
最大长度为 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
描述：用于复制作业的内容源外部键。
最大长度为 64。接受多字节字符。
州/省
必填：否
唯一：否
标头：状态
描述：与用户地址对应的州或省名称。
最大长度为 50。接受多字节字符。
街道 1
必填：否
唯一：否
标题：street_1
描述：用户地址的第一行。
最大长度为 100。接受多字节字符。
街道 2
必填：否
唯一：否
标题：street_2
描述：用户地址的第 2 行。
最大长度为 100。接受多字节字符。
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 对象：术语
学生信息系统 对象：术语
默认插入/更新行为：智能插入或更新
默认删除行为：禁用
批处理 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
替换批处理 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对象：中学机构角色关联
学生信息系统 对象：用户二级机构角色
默认插入/更新行为：智能插入或更新
默认删除行为：禁用
数据源密钥（必填）由集成或数据文件提供。
必需：是
唯一：否
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”
学习对象：观察者协会
学生信息系统 对象：观察者协会
默认插入/更新行为：智能插入或更新
默认删除行为：禁用
数据源密钥（必填）由集成或数据文件提供。
必需：是
唯一：否
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”
学习对象：类别
学生信息系统 对象：课程类别
默认插入/更新行为：智能插入或更新
默认删除行为：禁用
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”
学习对象：类别成员资格
学生信息系统 对象：类别成员资格
默认插入/更新行为：智能插入或更新
默认删除行为：禁用
批处理 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 对象：层次结构节点
学生信息系统 对象：层次结构节点
默认插入/更新行为：智能插入或更新
默认删除行为：清除
这些是创建机构层次结构节点所需的相应最少标题：
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 对象：层次结构用户关联
学生信息系统 对象：用户关联
默认插入/更新行为：智能插入或更新
默认删除行为：清除
将用户关联到机构层次结构节点所需的最少标题如下：
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对象：层次课程关联
学生信息系统 对象：课程关联
默认插入/更新行为：智能插入或更新
默认删除行为：清除
将课程关联到机构层次结构节点所需的最少标题如下：
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 对象：目标关联
学生信息系统 对象：目标关联
默认插入/更新行为：智能插入或更新
默认删除行为：清除
批处理 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”