Snapshot Flat File Header Descriptions

The Snapshot Flat File provides the ability to integrate using the latest LEARN data objects. Below is a comprehensive list of the supported objects, their UI to Feed Header naming conventions, usage description, and data requirements.

As the data feed is a text file all data is represented as a string. In some cases specific formatting and length are noted. Where required by the field supported values are provided. Required fields are highlighted and noted.

객체 학습: 사용자

학생 정보 시스템 개체: 인물

기본 삽입/업데이트 작업: 스마트 삽입 또는 업데이트

기본 삭제 작업: 비활성화

Learn Fields

Batch Uid (Required)

Required: Yes

Unique: Yes

Header: external_person_key

Description: A unique identifier for a user at the institution. This ID is provided by the institution and is not displayed to users.

It is strongly recommended that the key data be a permanent, non-changing identifier for each user. An example of a good key is a permanent Student ID assigned when the person applies to the institution. Please note that the database cannot merge data between distinct accounts.

Max length 64.

Data Source Key (Required) Supplied by the integration or the data file.

Required: Yes

Unique: No

Header: data_source_key

Description: Key used to establish grouping of user elements. Note this may be provided by the integration configuration and thus would not be required in the file.

Max. length: 256. Multi byte characters accepted.

First Name (Required)

Required: Yes

Unique: No

Header: firstname

Description: The user's given first name.


Max length 100. Multi byte characters accepted.

Last Name (Required)

Required: Yes

Unique: No

Header: lastname

Description: The user's family/last name.

Max length 100. Multi byte characters accepted.

Username (Required)

Required: Yes

Unique: Yes

Header: user_id

Description: The username used to log into Blackboard Learn. The username must be unique.

Max length 50. Multi byte characters accepted.

Name Pronunciation

Required: No

Unique: No

Header: TBC

Description: Phonetic spelling or pronunciation guide for user’s name.

Max length: 1000. Multi-byte characters accepted.

Password

Required: No

Unique: No

Header: passwd

Description: The password used to log into Blackboard Learn. If a password is not provided in the data feed Learn auto-populates this field with a SHA-512 password for security purposes.

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: 255

Available

Required: No

Unique: No

Header: available_ind

Description: User account availability within the user interface. If set to no, the user account will appear in gray to the Administrator and Instructors. The user will not be able to log into the system. Values may be "Y" for yes, or "N" for no.

Supported values: 'Y', 'N'.

Birthdate

Required: No

Unique: No

Header: birthdate

Description: The user's birth date.

Format: yyyymmdd.

City

Required: No

Unique: No

Header: city

Description: The city name corresponding to the user's address.

Max length 50. Multi byte characters accepted.

Company

Required: No

Unique: No

Header: company

Description: The name of the company for which the user works.

Max length 100. Multi byte characters accepted.

Country

Required: No

Unique: No

Header: country

Description: The country name corresponding to the user's address.

Max length 50. Multi byte characters accepted.

Department

Required: No

Unique: No

Header: department

Description: The name of the department or sub-section where the user works.

Max length 100. Multi byte characters accepted.

Education Level

Required: No

Unique: No

Header: educ_level

Description: The highest level of education achieved by the user.

Supported values: "K-8", "high school", "freshman", "sophomore", "junior", "senior", "graduate school", "post- graduate school"

Email

Required: No

Unique: No

Header: email

Description: The email address of the user. Blackboard recommends that user_email is not null. Users without an email address cannot send email.

Max length 100

Institution Email

Required: No

Unique: Yes

Header: inst_email

Description: The institution email address of the user. inst_email can be set to Null. No email communications are sent to the inst_email.

Max length 254

Pronouns

Required: No

Unique: No

Header: pronouns

Description: This is the user’s pronouns. Multiple pronoun values are accepted using comma as delimiter.

Max length 1000

Gender

Required: No

Unique: No

Header: gender

Description: The gender of the user.

Supported values: "Not Disclosed", "Male", "Female"

Home Phone

Required: No

Unique: No

Header: h_phone_1

Description: The user's home phone number.

Max length 50. Multi byte characters accepted.

Home Phone (Secondary)

Required: No

Unique: No h_phone_2

Description: An additional home phone number associated with the user.

Max length 50. Multi byte characters accepted.

Job Title

Required: No

Unique: No

Header: job_title

Description: The associated job title for the user.

Max length 100. Multi byte characters accepted.

Middle Name

Required: No

Unique: No middlename

Description: The user's given middle name.

Max length 100. Multi byte characters accepted.

Mobile Phone

Required: No

Unique: No

Header: m_phone

Description: The user's mobile phone or pager number.

Max length 50. Multi byte characters accepted.

Other Name

Required: No

Unique: No

Header: othername

Description: This is the user's alternate preferred name.

Max length: 100.

Password Encryption Type

Required: No

Unique: No

Header: pwencryptiontype

Description: This field sets the password encryption type used to encrypt the password in the database.

Supported values are: MD5, SSHA

Primary Institution Role

Required: No

Unique: No

Header: institution_role

Description: The user's Primary Institution Role, which determines the user's view of the Portal Modules and other items.

See "Manage Institution Roles" in the System Admin panel for the list of valid Institution Roles on the system.

Replacement Batch Uid

Required: No

Unique: Yes

Header: new_external_person_key

Description: This field is used only on the rare occasions when a user's EXTERNAL_PERSON_KEY changes.

Max length 64. Multi byte characters accepted.

Replacement Data Source Batch Uid

Required: No

Unique: No

Header: new_data_source_key

Description: New key used to establish grouping of user elements. Replaces existing data source associating data with the group designated by the specified replacement data source key. Note: The UI mapping field for Replacement Data Source Batch Uid is 'script.flatfile.UserReplacementDataSourceBatchUid'

Row Status

Required: No

Unique: No

Header: row_status

Description: Sets the value of the record to one of the following: Enabled: Normal access to the record. Disabled: Record is visible in some areas of the UI, but may not be changed or accessed. Deleted: Record is scheduled to be removed.

Supported values: "enabled", "disabled", "deleted"

Max length 64. Multi byte characters accepted.

State/Province

Required: No

Unique: No

Header: state

Description: The state or province name corresponding to the user's address.

Max length 50. Multi byte characters accepted.

Street 1

Required: No

Unique: No

Header: street_1

Description: The first line of the address of the user.

Max length 100. Multi byte characters accepted.

Street 2

Required: No

Unique: No

Header: street_2

Description: The second line of the address of the user.

Max length 100. Multi byte characters accepted.

Student ID

Required: No

Unique: No

Header: student_id

Description: Generic identifier field. This is a display only field.

Max length 100. Multi byte characters accepted.

Suffix

Required: No

Unique: No

Header: suffix The user's name suffix.

Max length 100. Multi byte characters accepted.

System Role

Required: No

Unique: No

Header: system_role

Description: The user's administrative role, describing the user's level of system administration privilege. The role of "none" has no system administration or Course creation privileges associated with it, and is the most commonly assigned role.

The following strings are acceptable:

To create user-defined system roles, match the "Role ID" found in Administrator Panel > System Role. If a role ID is not given, the system defaults to none.

Title

Required: No

Unique: No

Header: title

Description: The title that the user prefers to use.

Max length 100. Multi byte characters accepted.

Website

Required: No

Unique: No

Header: webpage

Description: The URL of the user's personal Web page, if they have one.

Max length 100

Work Phone

Required: No

Unique: No

Header: b_Phone _1

Description: The work phone number associated with the user.

Max length 50. Multi byte characters accepted.

Work Phone (Secondary)

Required: No

Unique: No

Header: b_phone_2

Description: An additional work phone number associated with the user.

Max length 50. Multi byte characters accepted.

Zip/Postal Code

Required: No

Unique: No

Header: zip_code

Description: The user's ZIP or Postal Code.

Max length 50. Multi byte characters accepted.

TOP

LEARN Object: Course and Organization

학생 정보 시스템 객체: 과정 또는 조직

기본 삽입/업데이트 작업: 스마트 삽입 또는 업데이트

기본 삭제 작업: 비활성화

Learn 필드

배치 UID(필수)

필수: 예

고유: 예

헤더: external_course_key.external_organization_key

설명: 교육 기관에서 강좌나 조직 부문을 고유하게 식별하기 위해 사용하는 짧은 명칭입니다. 이는 사용자에게 표시되지 않습니다. 문자, 숫자, 대시및 마침표만 포함할 수 있습니다. 공백이나 다른 구두점은 허용되지 않습니다. 각 코스와 조직은 고유해야 하며, 종종 COURSE_ID나 ORGANIZATION_ID와 동일합니다.

최대 길이: 64. 고유해야 합니다. 멀티바이트 문자를 사용할 수 있습니다.

코스 ID나 조직 ID(필수)

필수: 예

고유: 예

헤더: course_id 및 organization_id

설명: 교육 기관에서 강좌나 조직을 고유하게 식별하기 위해 사용하는 짧은 이름(예: math101_F99 또는 ChessClub)에는 다음 문자를 사용할 수 없습니다: 공백( ) 및 / ' +

최대 길이는 100자입니다. 이는 고유해야 하며 변경할 수 없습니다.

코스 또는 조직 이름(필수)

필수: 예

고유: 아니요

헤더: course_name/organization_name

설명: 이것은 코스나 조직의 전체 제목입니다. 이는 표시에 사용됩니다.

최대 길이: 255 멀티바이트 문자를 사용할 수 있습니다.

데이터 소스 키(필수)는 통합 또는 데이터 파일에서 제공됩니다.

필수: 예

고유: 아니요

헤더: data_source_key

설명: 코스나 조직 요소 그룹을 설정하는 데 사용되는 키입니다. 이는 통합 구성에 의해 제공될 수 있으므로 파일에서 요구되지 않습니다.

최대 길이: 256. 멀티바이트 문자를 사용할 수 있습니다.

코스 보기

필수: 아니오

고유: 아니요

헤더: course_experience

설명: 새 코스를 표시할 코스 보기를 결정합니다. 이 필드는 삽입 전용이며 학생 정보 시스템 프레임워크를 통한 업데이트가 불가능합니다.

지원되는 값: Original, Ultra 또는 교수자 선택입니다.

조직도 보기

필수: 아니오

고유: 아니요

헤더: organization_experience

설명: 클라이언트는 조직을 구축할 환경을 선택할 수 있습니다. 이 필드는 삽입 전용이며 학생 정보 시스템 프레임워크를 통한 업데이트가 불가능합니다.

지원되는 값: Original, Ultra 또는 교수자 선택입니다.

classificationId

필수: 아니오

고유: 아니요

헤더: classification_key

설명: 이것은 과정을 분류하는 데 사용되며 주제 영역 및 분야를 결정합니다. 이는 분류의 기본 키를 나타내는 ID입니다.

최대 길이는 450자입니다.

hasDescriptionPage

필수: 아니오

고유: 아니요

헤더: desc_page_ind

설명: 현재 이 필드는 지원되지 않습니다. 통합에서 이 필드를 사용해서는 안 됩니다.

numDaysOfUse

필수: 아니오

고유: 아니요

헤더: days_of_use

설명: 학생이 등록한 후 코스에 접근할 수 있는 기간입니다. 자기 주도 학습에 유용합니다. 이 값은 기간이 'FIXED'로 설정될 때만 사용되며, 생성 후 과정을 사용할 수 있는 일수를 나타냅니다.

숫자입니다. 120

serviceLevelType

필수: 아니오

고유: 아니요

헤더: service_level

설명: 일반적으로 데이터 피드에서는 사용되지 않습니다. 무시하다.

코스 유형을 지정합니다.

조직 = 커뮤니티

F = 전체 = 코스

등록됨(사용되지 않음)

T = Test_Drive = (사용되지 않음)

S = 시스템 = 코스 구성 데이터를 보호하기 위해 기능이 제한된 코스입니다.

지원되는 값: ‘F’, ‘C’, ‘R’, ‘T’, ‘S’

게스트 허용

필수: 아니오

고유: 아니요

헤더: allow_guest_ind

설명: 게스트가 코스에 접근할 수 있도록 허용합니다.

지원되는 값: ‘Y’, ‘N’

관찰자 허용

필수: 아니오

고유: 아니요

헤더: allow_observer_ind

설명: 코스 참관을 허용합니다.

지원되는 값: ‘Y’, ‘N’

사용 가능

필수: 아니오

고유: 아니요

헤더: available_ind

설명: Blackboard에서 강좌 또는 기관의 이용 가능성을 설정합니다. use_term_avail_ind가 'Y'일 때, 이 플래그는 무시되며 과정의 사용 가능 여부는 관련 학기에 의해 결정된다.

지원되는 값: ‘Y’, ‘N’

교차 배열된 코스 배치 UID

필수: 아니오

고유: 아니요

헤더: master_course_key

설명: 이 과정은 어린이EXTERNAL_COURSE_KEY의 학부모를 위한 과정입니다.

최대 길이: 64.

설명

필수: 아니오

고유: 아니요

헤더: description

설명: 이것은 코스에 대한 전체 설명입니다.

최대 길이는 4000자입니다. 멀티바이트 문자를 사용할 수 있습니다.

기간

필수: 아니오

고유: 아니요

헤더: duration

설명: 코스 사용 기간이 연속적인지, 날짜 범위인지, 등록일로부터 x일인지, 아니면 학기로 지정되어 있는지를 나타냅니다.

옵션:

지원되는 값: ‘C’, ‘R’, ‘D’, ‘T’

교육 속도를 조절하세요.

필수: 아니오

고유: 아니요

헤더: pace

설명: 과정이 교수자가 주도하는지 아니면 학생이 자기 주도하는 형태인지를 나타냅니다.

지원되는 값: ‘Self’, ‘교수자’

종료 날짜

필수: 아니오

고유: 아니요

헤더: end_date

설명: 이것은 코스 접근이 종료되는 날짜입니다.

형식: yyyymmdd

언어 팩 적용

필수: 아니오

고유: 아니요

헤더: locale_enforced

설명: 사용자가 코스에 접근할 때 언어 팩이 적용되는지 여부를 결정하는 플래그입니다. 언어 팩이 적용되지 않는 경우 사용자는 기본 언어 팩을 사용하여 코스를 볼 수 있습니다.

지원되는 값: ‘Y’, ‘N’

등록 액세스 코드

필수: 아니오

고유: 아니요

헤더: enroll_access_code

설명: 학생이 강좌에 등록할 때 사용할 수 있는 접근 코드입니다.

최대 길이는 50자입니다.

등록 종료 날짜

필수: 아니오

고유: 아니요

헤더: enroll_end

설명: 학생이 더 이상 등록할 수 없는 날짜입니다.

형식: yyyymmdd

등록 시작 날짜

필수: 아니오

고유: 아니요

헤더: enroll_start

설명: 등록이 시작될 수 있는 날짜입니다.

형식: yyyymmdd

등록 유형

필수: 아니오

고유: 아니요

헤더: enroll_option

등록 절차를 결정합니다.

지원되는 값: ‘교수자’, ‘self’ 또는 ‘email’.

제공된 정보에 따라 수정할 내용이 없으므로 원문 그대로 반환합니다: 요금

필수: 아니오

고유: 아니요

헤더: fee

설명: 이 과정이나 조직과 관련된 요금입니다.

숫자: 소수점 이하 두 자리를 포함한 11자리. 1500.00)

기관 이름

필수: 아니오

고유: 아니요

헤더: institution_name

교육 기관의 이름입니다.

최대 길이: 255 멀티바이트 문자를 사용할 수 있습니다.

언어 팩

필수: 아니오

고유: 아니요

헤더: locale

수정된 번역: 설명: 기본 언어 팩의 식별자입니다. 값은 xx_XX로 표현됩니다(예: 프랑스어 언어 팩은 fr_FR입니다).

최대 길이는 20자입니다.

잠김

필수: 아니오

고유: 아니요

헤더: lockout_ind

설명: 코스나 조직에 대한 접근 제한 여부를 나타냅니다. "Y"로 설정하면 코스나 조직에 대한 접근이 END_DATE및 START_DATE에 따라 제한됩니다.

지원되는 값: ‘Y’, ‘N’

최대 디스크 사용량(소프트 제한)

필수: 아니오

고유: 아니요

헤더: soft_limit

설명: 코스 할당량에 대한 유연한 제한입니다. 이 설정은 코스 폴더 저장소가 지정된 soft_limit에 도달하고 코스 할당량이 적용될 때 경고 이메일을 발송합니다.

10MB는 10485760바이트입니다.

기본 연결 배치 UID

필수: 아니오

고유: 예

헤더: external_association_key

설명: 이 코스는 주로 연결해야 할 노드의 외래 키입니다. 코스는 해당 노드의 도구 설정 기본값을 사용하여 고유한 설정을 생성합니다. "external_association_key"는 코스 협회 피드에서 동일한 필드를 가리킵니다. 다만 이 협회가 '기본' 협회라는 점을 제외하면, 코스 생성 시 도구 설정의 기본값을 복사한다는 의미입니다.

교육기관 계층 노드와 연결할 코스를 생성하기 위한 적절한 최소 필수 헤더는 다음과 같습니다.

external_course_key

course_id

course_name

external_association_key

primary_external_node_key

기본 노드 배치 UID

필수: 아니오

고유: 아니요

헤더: primary_external_node_key

설명: 코스 협회 피드의 'external_node_key' 필드와 동일합니다. 단, 이것이 기본 연관이라는 점을 제외하면 말이죠.

교육기관 계층 노드와 연결할 코스를 생성하기 위한 적절한 최소 필수 헤더는 다음과 같습니다.

external_course_key

course_id

course_name

external_association_key

primary_external_node_key

최대 길이: 256

교체 배치 UID

필수: 아니오

고유: 예

헤더: new_external_course_key

설명: 이 필드는 코스나 조직의 외부 키가 드물게 변경될 때만 사용됩니다.

최대 길이: 64. 고유해야 합니다. 멀티바이트 문자를 사용할 수 있습니다.

대체 데이터 원본 배치 UID

필수: 아니오

고유: 아니요

헤더: new_data_source_key

설명: 사용자 요소를 그룹화하는 데 사용되는 새로운 키입니다. 지정된 대체 데이터 소스 키를 사용하여 기존 데이터 소스의 연결 데이터를 지정된 그룹으로 대체합니다. 참고: 대체 데이터 소스 배치 UID에 대한 UI 매핑 필드는 ‘script.flatfile.CourseReplacementDataSourceBatchUid’입니다.

행 상태

필수: 아니오

고유: 아니요

헤더: row_status

설명: 레코드 값을 다음 중 하나로 설정하세요. 사용: 레코드에 대한 일반적인 접근입니다. 사용 불가: 레코드가 UI의 일부 영역에는 나타나지만 수정하거나 접근할 수 없습니다. 레코드가 삭제될 예정입니다.

지원되는 값: ‘enabled’, ‘disabled’, ‘deleted’

카탈로그에 표시

필수: 아니오

고유: 아니요

헤더: catalog_ind

설명: 코스 또는 조직을 카탈로그에 표시할지 설정합니다.

지원되는 값: ‘Y’, ‘N’

원본 조직 복사 키입니다.

필수: 아니오

고유: 아니요

헤더: template_course_key.template_organization_key

복사 작업에 사용될 콘텐츠 원본의 외부 키 설명입니다.

최대 길이: 64. 멀티바이트 문자를 사용할 수 있습니다.

시작 날짜

필수: 아니오

고유: 아니요

헤더: start_date

설명: 이것은 코스 섹션 접근이 시작되는 날짜입니다.

형식: yyyymmdd

학기

필수: 아니오

고유: 아니요

헤더: term_key

설명: 연결된 EXTERNAL_TERM_KEY입니다.

최대 길이는 256자입니다.

사용 기간 설정

필수: 아니오

고유: 아니요

헤더: use_term_availability_ind

설명: 물론, 관련 학기에 따라 가용성을 지정하는 플래그를 설정합니다. Y인 경우 available_ind, 시작 날짜 및 종료 날짜에 대한 용어가 사용됩니다. N일 때는 코스 설정이 사용됩니다.

지원되는 값: ‘Y’, ‘N’

TOP

LEARN Object: Course and Organization Membership

학생 정보 시스템 대상 요소: 과정 또는 조직 멤버십(등록 및 교직원 배정)

기본 삽입/업데이트 작업: 스마트 삽입 또는 업데이트

기본 삭제 작업: 비활성화

Learn 필드

코스 배치 UID 또는 조직 배치 UID(필수)

필수: 예

고유: 아니요

헤더: external_course_key 및 external_organization_key

설명: 코스나 조직을 확인하는 데 사용되는 동일한 키입니다.

최대 길이: 64. 멀티바이트 문자를 사용할 수 있습니다.

데이터 소스 키(필수)는 통합 또는 데이터 파일에서 제공됩니다.

필수: 예

고유: 아니요

헤더: 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’

도입

필수: 아니오

고유: 아니요

헤더: intro

설명: 사용자의 코스 홈페이지에 대한 소개 정보입니다.

최대 길이는 4000자입니다. 멀티바이트 문자를 사용할 수 있습니다.

참고 사항

필수: 아니오

고유: 아니요

헤더: notes

설명: 이 사용자와 관련된 정보는 코스 참여나 조직 참여에 영향을 줄 수 있습니다.

제한되지 않습니다. 멀티바이트 문자를 사용할 수 있습니다.

보호 정책

필수: 아니오

고유: 아니요

헤더: pinfo

설명: 사용자 홈페이지의 개인정보입니다.

제한되지 않습니다. 멀티바이트 문자를 사용할 수 있습니다.

법은 학생들에게 필요한 지식과 기술을 전달하는 것입니다.

필수: 아니오

고유: 아니요

헤더: primary_instructor

설명: 멤버십은 기본적으로 교수자임을 나타냅니다. 회원은 ‘교수자로 대우’라는 플래그가 있는 코스 역할을 맡아야 합니다. 구성원이 강사가 아니거나 이 플래그가 설정되지 않은 경우 해당 옵션이 표시되지 않습니다. "교수자로 취급" 플래그가 없는 코스 역할을 할당할 경우 멤버십 레코드의 Y가 거부됩니다.

지원되는 값: ‘Y’, ‘N’

이메일 수신

필수: 아니오

고유: 아니요

헤더: receive_email_ind

설명: 사용자의 전자 메일 활성화 여부를 표시합니다.

지원되는 값: ‘Y’, ‘N’

대체 데이터 원본 배치 UID

필수: 아니오

고유: 아니요

헤더: new_data_source_key

설명: 데이터 요소를 그룹화하는 데 사용되는 새로운 키입니다. 지정된 대체 데이터 소스 키를 사용하여 기존 데이터 소스의 연결 데이터를 지정된 그룹으로 대체합니다. 참고: 'script.flatfile.MemberReplacementDataSourceBatchUid'는 대체 데이터 소스 배치 UID에 대한 UI 매핑 필드입니다.

역할

필수: 아니오

고유: 아니요

헤더: 역할

설명: 사용자가 코스에서 수행하는 역할입니다.

지원되는 값: "Instructor", "teaching_assistant", "course_builder", "Grader", "Student", "guest", "none"

행 상태

필수: 아니오

고유: 아니요

헤더: row_status

설명: 레코드 값을 다음 중 하나로 설정하세요. 사용: 레코드에 대한 일반적인 접근입니다. 사용 불가: 레코드가 UI의 일부 영역에는 나타나지만 수정하거나 접근할 수 없습니다. 레코드가 삭제될 예정입니다.

지원되는 값: ‘enabled’, ‘disabled’, ‘deleted’

웹 사이트 1 설명

필수: 아니오

고유: 아니요

헤더: link_description_1

설명: 사용자 웹사이트에 대한 설명

최대 길이는 255자입니다

웹사이트1이름

필수: 아니오

고유: 아니요

헤더: link_name_1

수정: 사용자 웹사이트 링크에 사용된 이름

최대 길이는 100자입니다

웹사이트1URL

필수: 아니오

고유: 아니요

헤더: 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자입니다

웹사이트 URL 3개

필수: 아니오

고유: 아니요

헤더: link_url_3

수정된 번역: 설명: 사용자 웹사이트 링크에 사용되는 URL

최대 길이는 100자입니다

TOP

LEARN Object: Term

학생 정보 시스템 객체: 용어

기본 삽입/업데이트 작업: 스마트 삽입 또는 업데이트

기본 삭제 작업: 비활성화

Learn 필드

배치 UID(필수)

필수: 예

고유: 예

헤더: external_term_key

교육기관에서 학기를 고유하게 확인하기 위해 사용하는 약어입니다. 이는 사용자에게 표시되지 않습니다. 문자, 숫자, 대시및 마침표만 포함할 수 있습니다. 공백이나 기타 구두점은 허용되지 않습니다.

최대 길이는 256자입니다. 멀티바이트 문자를 사용할 수 있습니다.

데이터 소스 키(필수)는 통합 또는 데이터 파일에서 제공됩니다.

필수: 예

고유: 아니요

헤더: data_source_key

설명: 용어 요소를 그룹화하는 데 사용되는 키입니다. 이는 통합 구성에 의해 제공될 수 있으므로 파일에서 요구되지 않습니다.

최대 길이는 256자입니다. 멀티바이트 문자를 사용할 수 있습니다.

이름(필수)

필수: 예

고유: 아니요

헤더: name

설명: 학기의 이름입니다.

최대 길이는 333자입니다.

daysOfUse

필수: 아니오

고유: 아니요

헤더: days_of_use

설명: 학생이 등록한 후 코스에 접근할 수 있는 기간입니다. 자기 주도 학습에 유용합니다.

숫자입니다.

사용 가능

필수: 아니오

고유: 아니요

헤더: available_ind

설명: 용어의 가용성을 결정합니다. 'N'으로 설정된 경우 연결된 객체를 사용할 수 없습니다.

지원되는 값: ‘Y’, ‘N’

설명

필수: 아니오

고유: 아니요

헤더: description

용어설명

제한되지 않습니다.

기간

필수: 아니오

고유: 아니요

헤더: duration

설명: 학기 이용 가능 기간을 예약합니다.

옵션:

지원되는 값: 연속, 범위, 고정

종료 날짜

필수: 아니오

고유: 아니요

헤더: end_date

설명: 이 날짜는 학기에 접근할 수 없게 되는 날짜입니다.

형식: yyyymmdd

교체 배치 UID

필수: 아니오

고유: 예

헤더: new_external_term_key

설명: 이 필드는 'EXTERNAL KEY' 용어가 드물게 변경될 경우에만 사용됩니다.

최대 길이는 256자입니다. 멀티바이트 문자를 사용할 수 있습니다.

대체 데이터 원본 배치 UID

필수: 아니오

고유: 아니요

헤더: new_data_source_key

설명: 데이터 요소를 그룹화하는 데 사용되는 새로운 키입니다. 지정된 대체 데이터 소스 키를 사용하여 기존 데이터 소스의 연결 데이터를 지정된 그룹으로 대체합니다. 참고: 'script.flatfile.TermReplacementDataSourceBatchUid'는 대체 데이터 소스 배치 UID에 대한 UI 1매핑 필드입니다.

행 상태

필수: 아니오

고유: 아니요

헤더: row_status

설명: 레코드 값을 다음 중 하나로 설정하세요.

지원되는 값: ‘enabled’, ‘disabled’, ‘deleted’

시작 날짜

필수: 아니오

고유: 아니요

헤더: start_date

설명: 이 날짜는 학기에 접근이 가능해지는 시작일입니다.

형식: yyyymmdd

TOP

LEARN Object: Secondary Institution Role Association

학생 정보 시스템 객체: 사용자 지원 기관 역할

기본 삽입/업데이트 작업: 스마트 삽입 또는 업데이트

기본 삭제 작업: 비활성화

Learn 필드

데이터 소스 키(필수)는 통합 또는 데이터 파일에서 제공됩니다.

필수: 예

고유: 아니요

헤더: data_source_key

설명: 사용자 요소를 그룹화하는 데 사용되는 키입니다. 이는 통합 구성에 의해 제공될 수 있으므로 파일에서 요구되지 않습니다.

최대 길이는 256자입니다. 멀티바이트 문자를 사용할 수 있습니다.

보조 교육 기관의 역할 ID(필수)

필수: 예

고유: 아니요

헤더: role_id

설명: 이 연결에서 보조 교육 기관 역할을 식별하는 식별자입니다.

사용자 배치 UID(필수)

필수: 예

고유: 아니요

헤더: external_person_key

설명: 이 연결에 사용할 사용자의 external_person_key(batch_uid)입니다.

최대 길이: 64.

대체 데이터 원본 배치 UID

필수: 아니오

고유: 아니요

헤더: new_data_source_key

설명: 데이터 요소를 그룹화하는 데 사용되는 새로운 키입니다. 지정된 대체 데이터 소스 키를 사용하여 기존 데이터 소스의 연결 데이터를 지정된 그룹으로 대체합니다. 참고: 대체 데이터 소스 배치 UID에 대한 UI 매핑 필드는 'script.flatfile.SecondaryInstRoleReplacementDataSourceBatchUid'입니다.

행 상태

필수: 아니오

고유: 아니요

헤더: row_status

설명: 레코드 값을 다음 중 하나로 설정하세요. 사용: 레코드에 대한 일반적인 접근입니다. 사용 불가: 레코드가 UI의 일부 영역에는 나타나지만 수정하거나 접근할 수 없습니다. 레코드는 나중에 관리자가 수동으로 제거할 예정입니다. 작업을 통해서도 행이 자동으로 삭제되지 않습니다.

지원되는 값: ‘enabled’, ‘disabled’, ‘deleted’

TOP

LEARN Object: Observer Association

학생 정보 시스템 개체: 관찰자 협회

기본 삽입/업데이트 작업: 스마트 삽입 또는 업데이트

기본 삭제 작업: 비활성화

Learn 필드

데이터 소스 키(필수)는 통합 또는 데이터 파일에서 제공됩니다.

필수: 예

고유: 아니요

헤더: data_source_key

설명: 사용자 요소를 그룹화하는 데 사용되는 키입니다. 이는 통합 구성에 의해 제공될 수 있으므로 파일에서 요구되지 않습니다.

최대 길이: 256. 멀티바이트 문자를 사용할 수 있습니다.

관찰된 학생(필수)

필수: 예

고유: 아니요

헤더: external_user_key

설명: 이 연결에 사용할 사용자의 external_person_key(batch_uid)입니다. 학생을 교육하는 기관에서 사용자의 고유 식별자입니다. 이 ID는 교육 기관에서 제공하며 사용자에게는 표시되지 않습니다.

최대 길이: 64. 멀티바이트 문자를 사용할 수 있습니다.

관찰자(필수)

필수: 예

고유: 아니요

헤더: external_observer_key

설명: 이 연계에서 사용할 관찰자의 external_person_key(batch_uid)입니다. 교육 기관에서 참관인으로서 시스템 내 역할을 수행하는 사용자의 고유 식별자입니다.

최대 길이: 64. 멀티바이트 문자를 사용할 수 있습니다.

대체 데이터 원본 배치 UID

필수: 아니오

고유: 아니요

헤더: new_data_source_key

설명: 데이터 요소를 그룹화하는 데 사용되는 새로운 키입니다. 지정된 대체 데이터 소스 키를 사용하여 기존 데이터 소스의 연결 데이터를 지정된 그룹으로 대체합니다. 참고: 대체 데이터 소스 배치 UID에 대한 UI 매핑 필드는 'script.flatfile.AssociateObserverReplacementDataSourceBatchUid'입니다.

행 상태

필수: 아니오

고유: 아니요

헤더: row_status

설명: 레코드 값을 다음 중 하나로 설정하세요. 사용: 레코드에 대한 일반적인 접근입니다. 사용 불가: 레코드가 UI의 일부 영역에는 나타나지만 수정하거나 접근할 수 없습니다. 레코드가 삭제될 예정입니다.

지원되는 값: ‘enabled’, ‘disabled’, ‘deleted’

TOP

LEARN Object: Category

학생 정보 시스템 객체: 과정 분류

기본 삽입/업데이트 작업: 스마트 삽입 또는 업데이트

기본 삭제 작업: 비활성화

Learn 필드

dataSourceBatchUid(필수)

필수: 예

고유: 아니요

헤더: data_source_key

설명: 범주 요소를 그룹화하는 데 사용되는 키입니다.

멀티바이트 문자를 사용할 수 있습니다.

title(필수)

필수: 예

고유: 아니요

헤더: title

설명: UI 내에서 사용자에게 표시되는 카테고리 이름입니다.

최대 길이: 255 멀티바이트 문자를 사용할 수 있습니다.

배치 UID(필수)

필수: 예

고유: 예

헤더: external_category_key

고유해야 합니다. 이 필드는 UI에서 범주 연상 기호 필드에 해당합니다.

최대 길이: 64. 멀티바이트 문자를 사용할 수 있습니다.

설명

필수: 아니오

고유: 아니요

헤더: description

설명: 이것은 카테고리 설명입니다.

frontPageInd

필수: 아니오

고유: 아니요

헤더: frontpage_ind

설명: 카테고리가 카탈로그 첫 페이지에 표시될지 여부를 결정합니다.

지원되는 값: ‘Y’, ‘N’

사용 가능

필수: 아니오

고유: 아니요

헤더: 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

필수: 아니오

고유: 아니요

헤더: new_data_source_key

설명: 데이터 요소를 그룹화하는 데 사용되는 새로운 키입니다. 지정된 대체 데이터 소스 키를 사용하여 기존 데이터 소스의 연결 데이터를 지정된 그룹으로 대체합니다. 참고: 대체 데이터 소스 배치 UID에 대한 UI 매핑 필드는 'script.flatfile.CourseCatReplacementDataSourceBatchUid'입니다.

TOP

LEARN Object: Category Membership

학생 정보 시스템 개체: 카테고리 멤버십

기본 삽입/업데이트 작업: 스마트 삽입 또는 업데이트

기본 삭제 작업: 비활성화

Learn 필드

배치 UID(필수)

필수: 예

고유: 예

설명: 자동으로 채워졌습니다. 데이터 피드에서 사용하지 마십시오.

범주 배치 UID(필수)

필수: 예

고유: 아니요

헤더: external_category_key

설명: 코스/조직을 추가할 범주에 대한 EXTERNAL KEY(batch_uid)입니다.

최대 길이: 64.

코스 배치 UID 또는 조직 배치 UID(필수)

필수: 예

고유: 아니요

헤더: external_course_key

설명: external_organization_key는 코스나 조직을 분류하는 외부 키(batch_uid)입니다.

최대 길이: 64.

데이터 소스 키(필수)는 통합 또는 데이터 파일에서 제공됩니다.

필수: 예

고유: 아니요

헤더: data_source_key

설명: 사용자 요소를 그룹화하는 데 사용되는 키입니다. 이는 통합 구성에 의해 제공될 수 있으므로 파일에서 요구되지 않습니다.

멀티바이트 문자를 사용할 수 있습니다.

사용 가능

필수: 아니오

고유: 예

헤더: available_ind

설명: Blackboard Learn에서 카테고리 사용 설정을 합니다.

지원되는 값: ‘Y’, ‘N’

대체 데이터 원본 배치 UID

필수: 아니오

고유: 아니요

헤더: new_data_source_key

설명: 데이터 요소를 그룹화하는 데 사용되는 새로운 키입니다. 지정된 대체 데이터 소스 키를 사용하여 기존 데이터 소스의 연결 데이터를 지정된 그룹으로 대체합니다. 참고: 대체 데이터 원본 배치 UID에 대한 UI 매핑 필드는 'script.flatfile.CourseCatMemReplacementDataSourceBatchUid'입니다.

행 상태

필수: 아니오

고유: 아니요

헤더: row_status

설명: 레코드 값을 다음 중 하나로 설정하세요. 사용: 레코드에 대한 일반적인 접근입니다. 사용 불가: 레코드가 UI의 일부 영역에는 나타나지만 수정하거나 접근할 수 없습니다. 레코드가 삭제될 예정입니다.

지원되는 값: ‘enabled’, ‘disabled’, ‘deleted’

TOP

LEARN Object: Hierarchy Node

학생 정보 시스템 개체: 계층적 노드

기본 삽입/업데이트 작업: 스마트 삽입 또는 업데이트

기본 삭제 작업: 제거

Learn 필드

교육 기관 계층 노드를 생성하는 데 필요한 최소한의 헤더는 다음과 같습니다.

배치 UID(필수)

필수: 예

고유: 예

헤더: external_node_key

설명: 교육 기관에서 계층 노드를 고유하게 식별하는 데 사용하는 식별자입니다. 이는 사용자에게 표시되지 않습니다. 문자, 숫자, 대시및 마침표만 포함할 수 있습니다. 공백이나 다른 구두점은 허용되지 않습니다.

최대 길이: 255 멀티바이트 문자를 사용할 수 있습니다.

데이터 소스 키(필수)는 통합 또는 데이터 파일에서 제공됩니다.

필수: 예

고유: 아니요

헤더: data_source_key

설명: 사용자 요소를 그룹화하는 데 사용되는 키입니다. 이는 통합 구성에 의해 제공될 수 있으므로 파일에서 요구되지 않습니다.

최대 길이: 255 멀티바이트 문자를 사용할 수 있습니다.

부모 배치 UID(필수)

필수: 예

고유: 아니요

헤더: parent_node_key

설명: 이 노드의 상위는 external_node_key(배치 UID)입니다.

최대 길이: 64.

이름(필수)

필수: 예

고유: 아니요

헤더: name

노드 이름 설명

최대 길이: 255

설명

필수: 아니오

고유: 아니요

헤더: description

설명: 노드에 대한 설명입니다.

최대 길이: 1000.

교체 배치 UID

필수: 아니오

고유: 예

헤더: new_external_node_key

설명: 이 필드는 노드의 EXTERNAL KEY가 변경될 때 드물게 사용됩니다.

최대 길이: 255 고유해야 합니다. 멀티바이트 문자를 사용할 수 있습니다.

대체 데이터 원본 배치 UID

필수: 아니오

고유: 아니요

헤더: new_data_source_key

설명: 데이터 요소를 그룹화하는 데 사용되는 새로운 키입니다. 지정된 대체 데이터 소스 키를 사용하여 기존 데이터 소스의 연결 데이터를 지정된 그룹으로 대체합니다. 참고: 대체 데이터 소스 배치 UID에 대한 UI 매핑 필드는 'script.flatfile.NodeReplacementDataSourceBatchUid'입니다.

TOP

LEARN Object: Hierarchy User Association

학생 정보 시스템 엔터티: 사용자 연결

기본 삽입/업데이트 작업: 스마트 삽입 또는 업데이트

기본 삭제 작업: 제거

Learn 필드

교육기관 계층 노드에 사용자를 연결하는 데 필요한 최소 헤더는 다음과 같습니다.

데이터 소스 키(필수)는 통합 또는 데이터 파일에서 제공됩니다.

필수: 예

고유: 아니요

헤더: 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

설명: 이 필드는 연결된 EXTERNAL KEY가 드물게 변경될 경우에만 사용됩니다.

최대 길이: 64. 멀티바이트 문자를 사용할 수 있습니다.

대체 데이터 원본 배치 UID

필수: 아니오

고유: 아니요

헤더: new_data_source_key

설명: 데이터 요소를 그룹화하는 데 사용되는 새로운 키입니다. 지정된 대체 데이터 소스 키를 사용하여 기존 데이터 소스의 연결 데이터를 지정된 그룹으로 대체합니다. 참고: 대체 데이터 원본 배치 UID에 대한 UI 매핑 필드는 'script.flatfile.UserAssociationReplacementDataSourceBatchUid'입니다.

TOP

LEARN Object: Hierarchy Course Association

학생 정보 시스템 개체: 과정 연결

기본 삽입/업데이트 작업: 스마트 삽입 또는 업데이트

기본 삭제 작업: 제거

Learn 필드

교육기관 계층 노드에 강의를 연결하는 데 필요한 최소 헤더는 다음과 같습니다.

배치 UID(필수)

필수: 예

고유: 예

헤더: external_association_key

설명: 각 코스와 노드 연결에는 해당 관계를 식별하는 고유값이 있어야 합니다. 배치 UID는 강좌와 노드 관계의 고유 식별자입니다.

최대 길이: 64.

코스 배치 UID(필수)

필수: 예

고유: 아니요

헤더: external_course_key

설명: 이 노드에 연결할 코스는 external_course_key(batch_uid)입니다.

최대 길이: 64.

데이터 소스 키(필수)는 통합 또는 데이터 파일에서 제공됩니다.

필수: 예

고유: 아니요

헤더: data_source_key

설명: 요소 그룹을 설정할 때 사용되는 키입니다. 이는 통합 구성에 의해 제공될 수 있으므로 파일에서 요구되지 않습니다.

최대 길이: 255 멀티바이트 문자를 사용할 수 있습니다.

노드 배치 UID(필수)

필수: 예

고유: 아니요

헤더: external_node_key

설명: 이 연결의 노드입니다.

최대 길이: 64. 멀티바이트 문자를 사용할 수 있습니다.

기본연결지표

필수: 아니오

고유: 아니요

헤더: is_primary_association

설명: 다른 연결을 지정할 수 있는 경우, 이 연결을 기본 연결로 설정하는 설계입니다.

지원되는 값: 'Y', 'N'.

교체 배치 UID

필수: 아니오

고유: 예

헤더: new_external_association_key

설명: 이 필드는 연결된 EXTERNAL KEY가 드물게 변경될 경우에만 사용됩니다.

최대 길이: 64. 멀티바이트 문자를 사용할 수 있습니다.

대체 데이터 원본 배치 UID

필수: 아니오

고유: 아니요

헤더: new_data_source_key

설명: 데이터 요소를 그룹화하는 데 사용되는 새로운 키입니다. 지정된 대체 데이터 소스 키를 사용하여 기존 데이터 소스의 연결 데이터를 지정된 그룹으로 대체합니다. 참고: 대체 데이터 원본 배치 UID의 UI 매핑 필드는 ‘script.flatfile.CourseAssociationReplacementDataSourceBatchUid’입니다.

TOP

LEARN Object: Goal Association

학생 정보 시스템 개체: 목표 연결

기본 삽입/업데이트 작업: 스마트 삽입 또는 업데이트

기본 삭제 작업: 제거

Learn 필드

배치 UID(필수)

필수: 예

고유: 예

헤더: 헤더가 없으며 자동으로 채워집니다. 통합 피드에서 무시합니다.

설명: 코스와 목표 사이의 관계를 나타내는 고유 식별자입니다(표준).

최대 길이: 64.

코스 배치 UID(필수)

필수: 예

고유: 아니요

헤더: course_key

설명: 목표(표준)가 연결될 코스의 고유 식별자(external_course_key)

최대 길이: 64.

데이터 소스 키(필수)는 통합 또는 데이터 파일에서 제공됩니다.

필수: 예

고유: 아니요

헤더: data_source_key

설명: 사용자 요소를 그룹화하는 데 사용되는 키입니다. 이는 통합 구성에 의해 제공될 수 있으므로 파일에서 요구되지 않습니다.

최대 길이: 255 멀티바이트 문자를 사용할 수 있습니다.

하위 목표 집합(필수)

필수: 예

고유: 아니요

헤더: std_sub_doc_key

고유 식별자는 코스에 연결될 목표(표준)를 나타냅니다.

최대 길이: 64.

대체 데이터 원본 배치 UID

필수: 아니오

고유: 아니요

헤더: new_data_source_key

설명: 데이터 요소를 그룹화하는 데 사용되는 새로운 키입니다. 지정된 대체 데이터 소스 키를 사용하여 기존 데이터 소스의 연결 데이터를 지정된 그룹으로 대체합니다. 참고: 대체 데이터 소스 배치 UID에 대한 UI 매핑 필드는 'script.flatfile.GoalAssociationReplacementDataSourceBatchUid'입니다.