Skip to main content

필드 정의 방법

이 페이지에서는 성적 추출 페이로드에 포함할 수 있는 공통 필드 정의에 대해 설명합니다. "설명" 셀 하단에서 찾을 수 있는 실제 필드 정의는 데이터 값 필드에 배치해야 합니다.

코스 필드

필드

설명

기본키

코스의 내부 블랙보드 식별자입니다. 이 값은 코스 생성 시 Blackboard 스키마에 의해 생성되는 자동 증가 정수로, 대개 Blackboard 외부에서는 의미가 없습니다.

Course.getId

외부 코스 키

일반적으로 스냅샷 또는 유사한 통합을 통해 채워지는 사용자에게 표시되지 않는 고유한 식별자입니다. GUI를 통해 코스를 생성한 경우 "외부 코스 키"는 "코스 ID"와 일치합니다. 이 필드는 배치_UID로도 알려져 있습니다.

Course.getBatchUid

분류

분류 과정의 제목입니다.

Course.getClassification.getTitle

코스 ID

코스 고유의 사용자 대면 식별자입니다.

Course.getCourseId

사용 가능성

"Y"는 코스 기록을 사용할 수 있을 때, "N"은 사용할 수 없을 때입니다.

Course.getIsAvailable

유형

일반 코스의 경우 "FULL", 조직의 경우 "COMMUNITY"입니다. "SYSTEM"과 같은 다른 값이 내부 과정에 존재할 수 있으나, 이러한 과정에 대한 성적은 없습니다.

Course.getServiceLevelType.toFieldName

날짜 생성

코스 생성 날짜입니다.

Course.getCreatedDate

수정된 날짜

코스가 마지막으로 수정된 날짜입니다. 코스 기록의 수정은 콘텐츠나 과제 수정을 포함하지 않습니다.

Course.getModifiedDate

직위

"코스 이름"이 코스의 사용자 제목입니다.

Course.getTitle

범주 ID

코스에 대한 모든 코스 범주 ID(있는 경우)의 구분된 목록입니다. 하위 구분 기호는 추출 속성에서 구성됩니다. 예(파이프 하위 구분 기호 가정):

수학|대수학

Course.CATEGORY_IDS

범주 이름

코스에 대한 모든 코스 범주 이름(있는 경우)의 구분된 목록입니다. 하위 구분 기호는 추출 속성에서 구성됩니다. 예(파이프 하위 구분 기호 가정):

수학|대수학

Course.CATEGORY_NAMES

사용자 필드

필드

설명

기본키

사용자의 내부 Blackboard 식별자입니다. 이 값은 사용자가 생성될 때 Blackboard 스키마에서 자동으로 증가하는 정수로 생성되며, 일반적으로 Blackboard 외부에서는 의미가 없습니다.

User.getId

외부 개인 키

일반적으로 스냅샷 또는 유사한 통합을 통해 채워지는 사용자에게 표시되지 않는 고유한 식별자입니다. GUI를 통해 사용자를 생성할 때 '외부 사용자 키'는 '사용자 ID'와 일치합니다. 이 필드는 배치_UID로도 알려져 있습니다.

User.getBatchUid

직장 전화번호 1

사용자의 기본 비즈니스 전화번호입니다.

User.getBusinessPhone1

직장 전화번호 2

사용자의 보조 비즈니스 전화번호입니다.

User.getBusinessPhone2

회사

회사 사용자.

User.getCompany

국가

사용자 주소 국가입니다.

User.getCountry

부서

부서 사용자.

User.getDepartment

메일 주소

사용자 이메일 주소입니다.

User.getEmailAddress

"사용자의 성 또는 '가족' 이름입니다."

User.getFamilyName

이름

"주어진" 이름 또는 사용자 이름입니다.

User.getGivenName

집 전화 1

기본적인 사용자의 집 전화입니다.

User.getHomePhone1

집 전화 2

보조 집전화입니다.

User.getHomePhone2

사용 가능성

사용자 레코드를 사용할 수 있으면 "Y", 사용할 수 없으면 "N"입니다.

User.getIsAvailable

직책

직책은 사용자에게 있습니다.

User.getJobTitle

마지막 로그인 날짜

사용자가 시스템에 마지막으로 로그인하는 데 성공한 날짜입니다. 사용자가 로그인한 적이 없으면 이 값은 비어 있습니다.

User.getLastLoginDate

중간 이름

사용자의 중간 이름입니다.

User.getMiddleName

휴대폰

휴대폰 번호입니다.

User.getMobilePhone

학생 ID

사용자 기록의 학생 ID 속성입니다. 시스템에서 이 값이 고유하다고 보장되는 것은 아닙니다. 사용자 이름과 외부 사용자 키만이 고유한 필드로 보장됩니다.

User.getStudentId

직위

사용자의 직위입니다. (Mr. Mrs. Dr.)

User.getTitle

사용자 ID

사용자에게 표시되는 사용자의 고유한 식별자입니다. 사용자명이라고도 합니다.

User.getUserName

교육기관 내 역할 ID

사용자의 모든 교육기관 내 역할 ID가 콜론으로 구분된 목록입니다. 기본 역할 ID가 먼저 나오며, 그 다음에 해당 사용자의 모든 보조 역할 ID가 나타납니다(있는 경우).

Staff:Observer:Role_13

User.INSTITUTION_ROLE_IDS

교육기관 내 역할 이름

사용자의 모든 교육기관 내 역할 이름이 콜론으로 구분된 목록입니다. 기본 역할 이름을 먼저 지정한 다음 해당 사용자의 모든 보조 역할 이름이 순서대로 나열됩니다(해당하는 경우).

Staff:Observer:Role 13

User.INSTITUTION_ROLE_NAMES

교육기관 내 1차 역할 ID

교육기관 내 사용자의 기본 1차 역할 ID입니다.

User.PRIMARY_INSTITUTION_ROLE_ID

교육 기관의 기본 역할

사용자가 속한 기본 교육기관에서의 주요 역할의 명칭입니다.

User.PRIMARY_INSTITUTION_ROLE_NAME

교육기관 내 2차 역할 ID

사용자의 모든 2차 역할 ID(있는 경우)가 콜론으로 구분된 목록입니다.

관찰자 역할 13

User.SECONDARY_INSTITUTION_ROLE_IDS

교육기관 내 2차 역할 이름

사용자의 모든 2차 역할 이름(있는 경우)이 콜론으로 구분된 목록입니다.

관찰자 역할 13

User.SECONDARY_INSTITUTION_ROLE_NAMES

시스템 내 역할 ID

DEFAULT 도메인에 있는 사용자의 모든 시스템 내 역할 ID가 콜론으로 구분된 목록입니다. 기본 시스템 역할 ID가 먼저 나타나며, 이어서 해당 사용자의 모든 보조 시스템 역할 ID가 표시됩니다(해당하는 경우).

N:U:C

User.SYSTEM_ROLE_IDS

시스템 내 역할 이름

DEFAULT 도메인에 있는 사용자의 모든 시스템 내 역할 이름이 콜론으로 구분된 목록입니다. 기본 시스템 역할 이름이 첫 번째로 나오며, 그 뒤에 해당 사용자의 모든 보조 시스템 역할 이름이 따릅니다(해당하는 경우).

None:UserAdministrator:Course Administrator

User.SYSTEM_ROLE_NAMES

시스템 내 1차 역할 ID

기본 시스템 역할에 대한 사용자 ID입니다.

User.PRIMARY_SYSTEM_ROLE_ID

기본 시스템 역할 이름

기본 시스템 역할의 이름입니다.

PRIMARY_SYSTEM_ROLE_NAME

시스템 내 2차 역할 ID

DEFAULT 도메인에 있는 사용자의 모든 시스템 내 2차 역할 ID(있는 경우)가 콜론으로 구분된 목록입니다.

U:C

User.SECONDARY_SYSTEM_ROLE_IDS

시스템 내 2차 역할 이름

DEFAULT 도메인에 있는 사용자의 모든 시스템 내 2차 역할 이름(있는 경우)이 콜론으로 구분된 목록입니다.

코스 관리자: 사용자 관리

User.SECONDARY_SYSTEM_ROLE_NAMES

성적 필드

이 섹션의 필드는 Blackboard Learn 성적 관리 센터에서 특정 항목(또는 열)에 대한 학생 성적 정보에 접근하는 데 사용됩니다.

필드

설명

기본키

성적의 내부 Blackboard 식별자입니다. 이 값은 사용자가 생성될 때 Blackboard 스키마에서 자동으로 증가하는 정수로 생성되며, 일반적으로 Blackboard 외부에서는 의미가 없습니다.

Grade.getId

시도 성적

등록의 채점 가능 항목에 대한 최근 시도의 시각적 성적입니다. 시도는 성적이 과제나 평가가 아닐 경우 한 번만 가능합니다.

등급.get시도등급()

점수

등록된 채점 가능한 항목의 최신 시도에 대한 소수점입니다.

Grade.getAttemptScore()

시도한 날짜

시도가 생성된 날짜입니다. 학습자가 항목을 생성한 날짜는 평가 및 과제에 해당합니다. 성적을 수동으로 입력한 경우(예: 성적 관리 센터 스프레드시트에 직접 입력), 해당 날짜는 교수자가 성적을 입력한 날짜를 의미합니다. 교수자가 입력한 재정 날짜와 다른 필드를 혼동해서는 안 됩니다.

마지막시도일자를 가져오세요

시도 상태

시도 상태를 숫자로 표시하면 다음과 같습니다.

  1. 시도되지 않음

  2. 포기

  3. 진행 중

  4. 일시 중단

  5. 취소

  6. 채점 요구 사항

  7. 완료

등급.get상태()

수동 성적

학생에 대해 수동으로 덮어쓴 성적의 표시 값입니다. 성적이 수동으로 재정의되지 않은 경우, 이 값은 비어 있게 됩니다.

Grade.getManualGrade()

수동 채점

학생에 대해 수동으로 덮어쓴 성적의 점수(십진수)입니다. 성적이 수동으로 재정의되지 않은 경우, 이 값은 비어 있게 됩니다.

Grade.getManualScore()

성적 표시

성적 관리 센터에 표시되는 성적 값입니다. 이 값은 여러 번의 시도와 수동으로 재정의된 성적을 반영합니다. 대부분의 경우, 이 값은 추출하고자 하는 값입니다.

Grade.getSchemaValue

점수 표시

성적 관리 센터에서 성적을 소수점으로 나타낸 값입니다. 이 값은 여러 번의 시도와 수동으로 재정의된 성적을 반영합니다. 대부분의 경우, 이 값은 추출하고자 하는 값입니다.

등급.getScoreValue()

면제 표시자

강사가 성적을 면제했다면 ‘Y’, 아니면 ‘N’입니다.

면제 등급

Null등급표시기

"Y"이면 등급이 없는 것이고, 아니면 "N"입니다.

등급이 null인 경우

수동/재정의 등급 지시기

강사가 성적을 수동으로 재정의했다면 ‘Y’, 그렇지 않으면 ‘N’입니다.

등급을 재정의합니다.

덮어쓰기 날짜

교수자가 성적을 덮어쓴 날짜입니다. 성적 관리 센터 스프레드시트를 통해 수동으로 할당된 성적과 동일하지 않을 수도 있지만, 실제 재정의 성적이 지정(추가 또는 업데이트)된 날짜입니다.

Grade.getOverrideDate()

성적 관리 센터 항목 필드

이 섹션의 필드는 성적 관리 센터의 항목(또는 열)에 적용된다.

필드

설명

기본키

채점 가능한 항목의 내부 Blackboard 식별자입니다. 이 값은 사용자가 생성될 때 Blackboard 스키마에서 자동으로 증가하는 정수로 생성되며, 일반적으로 Blackboard 외부에서는 의미가 없습니다.

항목.getId()

외부 성적 표시자

항목이 코스의 외부 성적인 경우 "Y"이고, "N"이라고 합니다. 외부 성적으로 표시된 코스당 항목은 하나만 존재할 수 있습니다.

Item.IS_EXTERNAL_GRADE

표시 설명

사용자가 직접 채점할 수 있는 항목에 대한 설명입니다.

Item.getDescriptionForDisplay.getText

열 이름 표시

표시 열 이름은 Blackboard 성적 관리 센터에서 필수적인 값이며, 제목이 제공되지 않을 경우 최종 사용자에게 보여지는 값입니다.

항목.getDisplayName()

가능한 포인트

점수를 매길 수 있는 항목에서 가능한 최대 점수를 나타내는 십진수입니다.

항목.getDisplayPoint()

표시 제목

표시 제목은 필수 사항이 아니지만, 성적 관리 센터에서 항목에 제공될 경우 '열 이름 표시'가 아닌 최종 사용자에게 보여집니다.

()은 사용자에게 표시되는 제목입니다.

멤버십 필드

필드

설명

기본키

등록의 내부 Blackboard 식별자입니다. 이 값은 사용자가 생성될 때 Blackboard 스키마에서 자동으로 증가하는 정수로 생성되며, 일반적으로 Blackboard 외부에서는 의미가 없습니다.

Member.getId()

사용 가능성

"Y"는 등록 레코드를 사용할 수 있을 때를, "N"은 사용할 수 없을 때를 나타냅니다.

Member.getIsAvailable()

등록 날짜

사용자가 코스에 등록된 날짜입니다. 등록 날짜가 통합 시 명시적으로 제공되지 않은 경우, 이 값은 null이 될 수 있습니다.

회원가입일

수정된 날짜

등록 기록이 마지막으로 수정된 날짜입니다.

멤버.getModifiedDate()

마지막 접근 날짜

사용자가 코스에 마지막으로 접근한 날짜입니다. 사용자가 코스에 접근하지 않았다면 이 값은 null이 됩니다.

멤버.getLastAccessDate

정적 데이터 필드

필드

설명

정적 값

열 매핑에 정적 콘텐츠를 포함할 수 있습니다. 여기서 XXX는 포함할 정적 콘텐츠의 값입니다.

이 필드에서는 특수 문자를 정적 값의 일부로 포함할 수 있습니다. 특수 문자는 인코딩된 값으로 구성되어야 합니다. 예:

PROCESSSTATUS=::static::I%7C는 열 헤더 PROCESSSTATUS를 사용하여 추출 파일에 "I|" 값을 기록합니다.

::static::XXX

특수파생값

이 섹션의 필드는 다른 필드로부터 값을 파생시키는 특수 필드입니다.

필드

설명

Grade.PERCENTAGE_SCORE

이 값에는 계산할 수 있는 경우에만 가능한 점수로 나눈 점수가 포함됩니다. 그렇지 않으면 비어 있습니다.

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

등급.get범주명

성적 범주 이름(예: 과제)이 이 값이 됩니다.

User.EXTRACTOR_BATCH_UID

이 값은 추출을 승인한 사용자의 batch_uid가 됩니다.

EXTRACTOR_USER_ID

이 값은 추출을 승인한 사용자의 사용자 ID가 됩니다.

User.EXTRACTOR_FULLNAME

이 값은 추출을 승인한 사용자의 성명입니다.

User.EXTRACTOR_EMAIL

이 값은 추출을 승인한 사용자 이메일입니다.

User.GRADER_FULLNAME

이 값은 채점 가능한 항목을 마지막으로 채점한 사람의 전체 이름입니다.

User.GRADER_EMAIL

이 값은 채점 가능한 항목을 마지막으로 채점한 평가자의 이메일입니다.

Course.TERM_CODE

이 값은 연결된 코스 섹션의 학기 이름이 됩니다.

X::regEx:Y

값은 필드X에 대해 Y로 지정된 정규식 결과입니다.

코스 배치_uid가 202210_12345인 Course.getBatchUid::regEx:^.*?_(.*?)가 12345를 반환합니다.

Grade.getPostedDate

이 값은 게시한 날짜가 됩니다(Ultra 코스의 경우).

Term.getSourceId

이 값은 연결된 강의가 속한 학기의 소스 ID가 됩니다.