필드 정의 방법
이 페이지에서는 성적 추출 페이로드에 포함할 수 있는 공통 필드 정의에 대해 설명합니다. "설명" 셀 하단에서 찾을 수 있는 실제 필드 정의는 데이터 값 필드에 배치해야 합니다.
코스 필드
필드 | 설명 |
|---|---|
기본키 | 코스의 내부 블랙보드 식별자입니다. 이 값은 코스 생성 시 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 속성입니다. 시스템에서 이 값이 고유하다고 보장되는 것은 아닙니다. 사용자 이름과 외부 사용자 키만이 고유한 필드로 보장됩니다.
|
직위 | 사용자의 직위입니다. (Mr. Mrs. Dr.)
|
사용자 ID | 사용자에게 표시되는 사용자의 고유한 식별자입니다. 사용자명이라고도 합니다.
|
교육기관 내 역할 ID | 사용자의 모든 교육기관 내 역할 ID가 콜론으로 구분된 목록입니다. 기본 역할 ID가 먼저 나오며, 그 다음에 해당 사용자의 모든 보조 역할 ID가 나타납니다(있는 경우). Staff:Observer:Role_13
|
교육기관 내 역할 이름 | 사용자의 모든 교육기관 내 역할 이름이 콜론으로 구분된 목록입니다. 기본 역할 이름을 먼저 지정한 다음 해당 사용자의 모든 보조 역할 이름이 순서대로 나열됩니다(해당하는 경우). Staff:Observer:Role 13
|
교육기관 내 1차 역할 ID | 교육기관 내 사용자의 기본 1차 역할 ID입니다.
|
교육 기관의 기본 역할 | 사용자가 속한 기본 교육기관에서의 주요 역할의 명칭입니다.
|
교육기관 내 2차 역할 ID | 사용자의 모든 2차 역할 ID(있는 경우)가 콜론으로 구분된 목록입니다. 관찰자 역할 13
|
교육기관 내 2차 역할 이름 | 사용자의 모든 2차 역할 이름(있는 경우)이 콜론으로 구분된 목록입니다. 관찰자 역할 13
|
시스템 내 역할 ID | DEFAULT 도메인에 있는 사용자의 모든 시스템 내 역할 ID가 콜론으로 구분된 목록입니다. 기본 시스템 역할 ID가 먼저 나타나며, 이어서 해당 사용자의 모든 보조 시스템 역할 ID가 표시됩니다(해당하는 경우). N:U:C
|
시스템 내 역할 이름 | DEFAULT 도메인에 있는 사용자의 모든 시스템 내 역할 이름이 콜론으로 구분된 목록입니다. 기본 시스템 역할 이름이 첫 번째로 나오며, 그 뒤에 해당 사용자의 모든 보조 시스템 역할 이름이 따릅니다(해당하는 경우). None:UserAdministrator:Course Administrator
|
시스템 내 1차 역할 ID | 기본 시스템 역할에 대한 사용자 ID입니다.
|
기본 시스템 역할 이름 | 기본 시스템 역할의 이름입니다.
|
시스템 내 2차 역할 ID | DEFAULT 도메인에 있는 사용자의 모든 시스템 내 2차 역할 ID(있는 경우)가 콜론으로 구분된 목록입니다. U:C
|
시스템 내 2차 역할 이름 | DEFAULT 도메인에 있는 사용자의 모든 시스템 내 2차 역할 이름(있는 경우)이 콜론으로 구분된 목록입니다. 코스 관리자: 사용자 관리
|
성적 필드
이 섹션의 필드는 Blackboard Learn 성적 관리 센터에서 특정 항목(또는 열)에 대한 학생 성적 정보에 접근하는 데 사용됩니다.
필드 | 설명 |
|---|---|
기본키 | 성적의 내부 Blackboard 식별자입니다. 이 값은 사용자가 생성될 때 Blackboard 스키마에서 자동으로 증가하는 정수로 생성되며, 일반적으로 Blackboard 외부에서는 의미가 없습니다.
|
시도 성적 | 등록의 채점 가능 항목에 대한 최근 시도의 시각적 성적입니다. 시도는 성적이 과제나 평가가 아닐 경우 한 번만 가능합니다.
|
점수 | 등록된 채점 가능한 항목의 최신 시도에 대한 소수점입니다.
|
시도한 날짜 | 시도가 생성된 날짜입니다. 학습자가 항목을 생성한 날짜는 평가 및 과제에 해당합니다. 성적을 수동으로 입력한 경우(예: 성적 관리 센터 스프레드시트에 직접 입력), 해당 날짜는 교수자가 성적을 입력한 날짜를 의미합니다. 교수자가 입력한 재정 날짜와 다른 필드를 혼동해서는 안 됩니다.
|
시도 상태 | 시도 상태를 숫자로 표시하면 다음과 같습니다.
|
수동 성적 | 학생에 대해 수동으로 덮어쓴 성적의 표시 값입니다. 성적이 수동으로 재정의되지 않은 경우, 이 값은 비어 있게 됩니다.
|
수동 채점 | 학생에 대해 수동으로 덮어쓴 성적의 점수(십진수)입니다. 성적이 수동으로 재정의되지 않은 경우, 이 값은 비어 있게 됩니다.
|
성적 표시 | 성적 관리 센터에 표시되는 성적 값입니다. 이 값은 여러 번의 시도와 수동으로 재정의된 성적을 반영합니다. 대부분의 경우, 이 값은 추출하고자 하는 값입니다.
|
점수 표시 | 성적 관리 센터에서 성적을 소수점으로 나타낸 값입니다. 이 값은 여러 번의 시도와 수동으로 재정의된 성적을 반영합니다. 대부분의 경우, 이 값은 추출하고자 하는 값입니다.
|
면제 표시자 | 강사가 성적을 면제했다면 ‘Y’, 아니면 ‘N’입니다.
|
Null등급표시기 | "Y"이면 등급이 없는 것이고, 아니면 "N"입니다.
|
수동/재정의 등급 지시기 | 강사가 성적을 수동으로 재정의했다면 ‘Y’, 그렇지 않으면 ‘N’입니다.
|
덮어쓰기 날짜 | 교수자가 성적을 덮어쓴 날짜입니다. 성적 관리 센터 스프레드시트를 통해 수동으로 할당된 성적과 동일하지 않을 수도 있지만, 실제 재정의 성적이 지정(추가 또는 업데이트)된 날짜입니다.
|
성적 관리 센터 항목 필드
이 섹션의 필드는 성적 관리 센터의 항목(또는 열)에 적용된다.
필드 | 설명 |
|---|---|
기본키 | 채점 가능한 항목의 내부 Blackboard 식별자입니다. 이 값은 사용자가 생성될 때 Blackboard 스키마에서 자동으로 증가하는 정수로 생성되며, 일반적으로 Blackboard 외부에서는 의미가 없습니다.
|
외부 성적 표시자 | 항목이 코스의 외부 성적인 경우 "Y"이고, "N"이라고 합니다. 외부 성적으로 표시된 코스당 항목은 하나만 존재할 수 있습니다.
|
표시 설명 | 사용자가 직접 채점할 수 있는 항목에 대한 설명입니다.
|
열 이름 표시 | 표시 열 이름은 Blackboard 성적 관리 센터에서 필수적인 값이며, 제목이 제공되지 않을 경우 최종 사용자에게 보여지는 값입니다.
|
가능한 포인트 | 점수를 매길 수 있는 항목에서 가능한 최대 점수를 나타내는 십진수입니다.
|
표시 제목 | 표시 제목은 필수 사항이 아니지만, 성적 관리 센터에서 항목에 제공될 경우 '열 이름 표시'가 아닌 최종 사용자에게 보여집니다.
|
멤버십 필드
필드 | 설명 |
|---|---|
기본키 | 등록의 내부 Blackboard 식별자입니다. 이 값은 사용자가 생성될 때 Blackboard 스키마에서 자동으로 증가하는 정수로 생성되며, 일반적으로 Blackboard 외부에서는 의미가 없습니다.
|
사용 가능성 | "Y"는 등록 레코드를 사용할 수 있을 때를, "N"은 사용할 수 없을 때를 나타냅니다.
|
등록 날짜 | 사용자가 코스에 등록된 날짜입니다. 등록 날짜가 통합 시 명시적으로 제공되지 않은 경우, 이 값은 null이 될 수 있습니다.
|
수정된 날짜 | 등록 기록이 마지막으로 수정된 날짜입니다.
|
마지막 접근 날짜 | 사용자가 코스에 마지막으로 접근한 날짜입니다. 사용자가 코스에 접근하지 않았다면 이 값은 null이 됩니다.
|
정적 데이터 필드
필드 | 설명 |
|---|---|
정적 값 | 열 매핑에 정적 콘텐츠를 포함할 수 있습니다. 여기서 XXX는 포함할 정적 콘텐츠의 값입니다. 이 필드에서는 특수 문자를 정적 값의 일부로 포함할 수 있습니다. 특수 문자는 인코딩된 값으로 구성되어야 합니다. 예: PROCESSSTATUS=::static::I%7C는 열 헤더 PROCESSSTATUS를 사용하여 추출 파일에 "I|" 값을 기록합니다.
|
특수파생값
이 섹션의 필드는 다른 필드로부터 값을 파생시키는 특수 필드입니다.
필드 | 설명 |
|---|---|
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가 됩니다. |