Skip to main content

성적표 추출 구성

성적부 추출은 성적 승인 없이도 발췌문에 포함되어 완전히 자동화된 과정입니다. '성적 추출 설정'에 접근하려면:

  1. 관리자 패널에 접속하십시오.

  2. 플랫폼 확장을 클라우드 관리에서 선택하세요.

  3. Grade Export v2 메뉴에서 설정 편집을 선택하세요.

  4. GRADEBOOK_EXTRACT 행의 설정 열에서 돋보기 아이콘을 클릭하세요.

이를 통해 '성적 추출 설정' 탭에 접근할 수 있습니다. 이 탭에는 확장 가능한 여섯 개 섹션이 있습니다.

  • 일반 설정 통합 유형 설정, 일정 설정 및 성적 유효성 표시

  • 기간 필터 — 포추출에 포함될 기간을 나타냅니다.

  • 코스 필터 — 추출물에 포함될 과정을 표시하세요.

  • 열 필터 — 추출물에 포함될 등급의 열을 표시하세요.

  • 열 매핑 — 필드 이름을 추출될 데이터에 매핑하도록 설정하세요.Blackboard

  • 결과 전송 설정 — 추출 파일이 전달될 교육 기관의 위치를 입력하세요.

일반적인 배경

  1. 통합 유형을 선택하십시오.

    • 일반 통합: 구분된 파일 형식

    • REST 통합: Grades Journey 특정 JSON 형식

    • 레거시 배너 통합: 레거시 배너 REST API 형식

  2. CRON 스케줄은승인된 성적 파일이 추출되는 빈도를 결정합니다. CRON 표현식을 사용하여 추출 빈도를 지정하십시오.

  3. 소수점 이하자릿수 필드에 점수 값에 대해 소수점 이하에 표시될 자릿수를 입력하십시오. 값은 반올림이 아닌 절삭으로 표현되며, 기본값은 5이다.

  4. 채점되지 않은 항목이나 평가에 대해 값이 저장되지 않은 필드에 반환할 null 값을 입력하세요(예: '0' 또는 'noValue').

  5. 유효 성적 필드에 쉼표로 구분된 유효한 성적 값 목록을 명시하세요. 이것들은 숫자가 아닌, 문자 성적이어야 합니다. 성적 값이 유효하지 않을 경우 추출에서 제외되며 이메일 알림이 발송됩니다. 추출에서 제외된 유효하지 않은 기록은 이메일 알림에 첨부된 파일에 추가됩니다.

    참고

    이 상자를 비워두면, 모든 성적이 유효한 것으로 간주됩니다.

  6. 날짜 열 형식 필드에 유효한 날짜 형식 마스크를 입력하십시오. 이 형식은 추출된 날짜 값에 사용됩니다. Java SimpleDateFormat을 사용합니다.

학기 필터

  1. Enabled 토글을 켜서 추출물을 학기별로 필터하세요.

  2. ADD 또는 DELETE 를 선택하여 행을 추가하거나 삭제하십시오.

  3. 기간 열에서 추출을 필터링할 기간을 선택하십시오. 선택한 학기에 관련된 과목만 추출문에 포함됩니다.

  4. 해당 열에 유효 시작일과 종료일을 입력하십시오. 현재 날짜가 유효 시작일과 종료일 사이에 있는 경우, 데이터는 주어진 기간과 관련된 강좌에서 추출됩니다. 해당 날짜 필드를 비워두면, 추출은 날짜 제한을 받지 않습니다.

코스 필터

코스는 포함되기 위해 모든 설정된 기준을 만족시켜야 합니다.

  1. 에서 사용 가능한 과목만 옵션을 활성화하여 성적부 추출 내역에 사용 가능한 과목 데이터만 포함되도록 설정하세요.

  2. 과목을 검색하여 성적 추출에 포함시키세요. 검색 조건을 입력하면 반환되는 강의가 모두 포함됩니다. 제목, 저자, 출판일 및 키워드.

    • 배치 UID

    • 코스 ID

    • 코스명

    • 데이터 소스 키

    • 학기

    • 강좌 개설 일자

    • 강의 날짜 범위를 입력하세요.

  3. 성적부에서 제외할 과목 목록을 박스에 쉼표로 구분하여 입력하십시오.

열 필터

열 필터는 특정 등급의 열이 추출되는지 결정하는 데 사용됩니다.

  • 열 필터 프로비저닝이 비활성화되었을 때 특정 열을 추출하고자 한다면 이 박스를 채우십시오. 열 이름을 쉼표로 구분된 목록 형식으로 입력하십시오. 이 설정은 보고서에 포함해야 할 열만 추출 파일에 포함되도록 하는 것이 목적입니다.

  • 외부 성적 열(원본) 또는 전체 성적(울트라) 전용 원본 강좌에서 외부 성적 열만 추출하고자 할 경우 이 체크박스를 선택하십시오. 이 설정은 '열 필터' 설정과 '프로비저닝 활성화' 설정보다 우선합니다. 이 항목을 선택하면 해당 열만 추출됩니다.

  • 프로비저닝 활성화 SIS에서 제공된 채점 항목 중 성적 열만 추출하려면 이 체크박스를 선택하십시오. 이 설정은 열 필터 설정보다 우선합니다.

  • 지난 실행 이후 변경된 행만 포함하세요 마지막 추출 이후 성적 값이 변경된 성적 열 기록만 포함하려면 이 체크박스를 선택하십시오.

  • '전부 계산된' 열을 제외하세요. 이 체크박스를 이전 열의 필터와 함께 선택하면 열 값이 변경될 때 계산된 열이 성적 추출에 포함되지 않습니다.

  • ‘모국’ 기록이 비어 있으면 제외하세요 성적 값이 없는 기록이 성적부 추출에 포함되지 않도록 이 체크박스를 선택하세요.

  • 열 메타데이터 유효성 검사 를 활성화하면 해당 검사 상자가 표시됩니다. 선택적으로, 강좌 추출 가능 여부를 결정하기 위해 키/값 쌍 세트와 해당 쌍이 성적 열 메타데이터에 나타날 예상 횟수를 입력하십시오. 시스템은 이 매개변수들이 충족되지 않을 경우 오류를 반환하며 강의에서 데이터를 추출하지 않습니다.

열의 매핑

보고서의 각 레코드에 포함할 성적 열 데이터 필드를 식별하기 위해 파이프 기호(|)로 구분된 이름/값 쌍 목록을 입력하십시오. 이 필드가 비어 있으면 추출 과정 중 기본 필드 목록이 전달됩니다.

예시 매핑은 다음과 같습니다:

external_course_key=Course.getBatchUid|External_person_key.=User.getBatchUid|student_id=User.getStudentId|column=Item.getDisplayColumnName|grade=Grade.getSchemaValue

추가열매핑

추출에 포함하고자 하는 경우, 다음의 각 '추가 데이터' 필드에 대해 '활성화' 토글을 켜십시오:

  • 최종 출석일 은과제 또는 평가 시도가 생성된 최종 날짜. 헤더 값은 '추출 키' 필드를 업데이트하여 수정할 수 있습니다. 기본값은 last_attendance_date입니다.

  • 교수자피드백 계산된 성적 열에 대해 교수자 또는 승인자가 제공한 의견(코멘트). 헤더 값은 '추출 키' 필드를 업데이트하여 수정할 수 있습니다. 기본 값은 instructor_comment입니다. 이 설정은 승인 워크플로우에서 교수의 피드백을 제공하기 때문에 성적부 추출 시 일반적으로 적용되지 않습니다.

결과 전송 설정

일반 통합 옵션

결과 전송 설정

  1. 파일명 마스크 필드에서 파일 추출 이름의 패턴을 설정하세요. 전송 유형이 '결합 파일(Combined File)'로 설정되면, 파일 이름의 시작 부분에 'combined_'가 추가됩니다.

  2. 전송 방법을 선택하십시오. SFTP는 전송 방식 중 가장 일반적이며,해당 설정은 다음 단계에 설명되어 있습니다.

  3. 전송 유형을 선택하십시오.

    • 각 파일은 강좌별 단일 추출 파일을 개별적으로 전송합니다.

    • 통합 파일 결과는 하나의 파일로 구성되어 모든 강의 승인된 행을 포함하게 됩니다.

  4. Windows EOL이 필요한 Windows 환경에서 처리되는 경우, 'Windows EOL 사용'을 활성화하십시오.

  5. 서버 필드에 SFTP 서버의 URL 또는 IP를 입력하십시오.

  6. 포트' 필드에 SFTP 서버 포트(일반적으로 22)를 입력하십시오.

  7. 사용자 이름 필드에 SFTP 사용자명을 입력하세요.

  8. 비밀번호'필드에 SFTP 비밀번호를 입력하십시오.

  9. 경로 필드에 추출 파일 경로를 입력하세요.

추출 파일 형식

  1. 필드 구분자를 추출 파일에 사용할 값을 입력하세요. 기본값은 파이프(|)입니다.

  2. 필드 한정자를 입력하십시오. 이는 추출된 데이터에 구분 기호(delimiter)가 포함된 경우에 사용할 문자입니다. 기본값은 이중 따옴표(“”)입니다.

REST 통합 옵션

결과 전송 설정

  1. '게시 웹 서비스 엔드포인트' 필드에 성적을 게시할 엔드포인트를 지정하십시오.

  2. '최대 REST 레코드 수' 필드에 단일 트랜잭션에 포함될 최대 레코드 수를 입력하십시오.

나머지 보안 옵션

Secure REST API를 활성화하려면 '예'를 선택하십시오. 활성화된 경우, 보안 메커니즘도 설정하십시오.

OAuth 1.0

  • 공유 보안 비밀: OAuth 공유 보안 비밀을 입력하십시오.

  • API 키: OAuth API 키를 입력합니다.

MAC 보안

MAC 보안에 대한 정보를 더 확인하세요.

  • 공유 비밀번호: 공유 비밀번호를 입력하세요.

  • API 키: API 키를 입력하세요

  • 타임스탬프 매개변수: 쿼리 문자열에서 타임스탬프 값을 나타내는 매개변수를 입력하세요.

  • MAC 매개변수: 쿼리 문자열에서 MAC 값을 나타내는 매개변수를 입력하십시오.

  • API 키 매개변수: 쿼리 문자열에서 API 키 값을 나타낼 매개변수를 입력하십시오.

OAuth 2.0

Grade Export는 REST 토큰 URL 구성 엔드포인트에 요청을 보냅니다. 승인은 요청 헤더를 통해 전송됩니다. 보조금 유형은 요청 본문에 'client_credentials' 및 'grant_type: "client_credentials"'로 전송됩니다.

  • REST 키: API 접근에 사용할 키를 입력하십시오.

  • REST 비밀: API 접근에 사용될 비밀 값을 입력하십시오.

  • REST 토큰 URL: 접근 토큰 요청을 위한 URL을 입력하세요.

제출 를 선택해 선택지를 저장하십시오.