승인 워크플로우 구성
승인 워크플로가 활성화되면 특정 일정에 따라 실행되어 승인된 성적이 자동으로 추출됩니다. 승인 워크플로에서 성적 추출 설정에 접근하려면 다음을 수행하십시오:
관리자 패널에 접속하십시오.
클라우드 관리에서 플랫폼 확장을 선택하세요.
설정 편집을 Grade Export v2 메뉴에서 선택하십시오.
APPROVAL_WORKFLOW 행의 구성 열에서 돋보기를 선택하십시오.
이 작업을 통해 점수 추출 설정 탭에 액세스할 수 있습니다. 이 탭에는 7개의 확장 가능한 섹션이 있습니다.
일반적인 배경
통합 유형를 선택하세요.
일반 통합: 구분된 파일 형식
REST 통합: Grades Journey 특정 JSON 형식
레거시 배너 통합: 레거시 배너 REST API 형식
CRON 스케줄은 승인된 성적 파일이 추출되는 빈도를 결정합니다. 활성화 모드를 켜시겠습니까? 지정된 CRON 스케줄에 따라 프로세스를 실행하려면 토글을 사용하고 추출 빈도를 정하는 CRON 표현식을 입력하세요.
소수점 자리 수 필드에 점수 값의 소수점 이하에 표시될 자릿수를 입력하세요. 값은 반올림되지 않고 자르기 처리되며 기본값은 5입니다.
평가되지 않은 항목에 대한 값 추출 필드에 채점되지 않은 항목이나 값이 저장되지 않은 필드에 반환될 널 값을 입력하세요(예: ‘0’ 또는 ‘noValue’).
유효 점수 필드에 유효한 점수 값으로 간주될 성적 목록을 콤마로 구분하여 지정하세요. 이 값들은 숫자가 아닌 문자 점수여야 합니다. 만약 점수 값이 유효하지 않으면, 추출에서 제외되며 이메일 알림을 트리거합니다. 유효하지 않아서 추출에서 제외된 레코드는 이메일 알림에 첨부된 파일에 추가됩니다.
참고
이 상자를 비워두면, 모든 성적이 유효한 것으로 간주됩니다.
날짜 열 형식 필드에 유효한 날짜 형식 마스크를 입력하세요. 이 형식은 추출에 포함된 모든 날짜 값에 사용됩니다. Java SimpleDateFormat을 사용하세요.
학기 필터
활성화 토글을 켜서 학기별로 필터링 된 추출을 가능하게 하세요.
추가 또는 삭제 를 선택하여 행을 추가하거나 삭제하세요.
학기 열에서 필터링에 사용하고자 하는 학기를 선택하세요. 선택된 학기에 연결된 코스만 추출에 포함됩니다.
해당 열에 유효 시작일과 종료일을 입력하십시오. 현재 날짜가 유효 시작일과 종료일 사이에 있는 경우, 데이터는 주어진 기간과 관련된 강좌에서 추출됩니다. 해당 날짜 필드를 비워두면, 추출은 날짜 제한을 받지 않습니다.
열 필터
필터는 채점자가 등급을 확인하고 승인할 수 있도록 등급 열을 표시하는 데 사용됩니다. 한 가지 필터 옵션만 한 번에 활성화할 수 있습니다.
열 필터 프로비저닝이 비활성화되었을 때 특정 열만 채점자에게 표시하려면 이 박스를 체크하세요. 열 이름을 쉼표로 구분된 목록 형식으로 입력하십시오. 이 설정은 보고서에 포함해야 할 열만 추출 파일에 포함되도록 하는 것이 목적입니다.
외부 성적 열(Original) 또는 전체 성적(Ultra)만 표시 채점자에게 외부 성적 열(Original 강좌) 또는 전체 성적(Ultra 강좌)만 표시하려면 이 확인란을 선택하십시오. 이 설정은 열 필터 설정 및 프로비저닝 활성화 설정보다 우선 적용됩니다.
프로비저닝 활성화 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입니다.
추출 과정에서의 역할 설정
제출자 워크플로 활성화 토글을 켜서, 제출자가 성적을 검토자에게 제출하는 추가 단계를 워크플로에 추가하세요(예: 조교가 강사 승인을 위해 성적 제출).
승인에 필요한 역할의 경우, 교수자와 같은 사용자가 성적 승인 프로세스를 시작하고 성적을 승인할 수 있도록 요구되는 수업 내 역할 및 기타 추가 교육기관 역할(예: 성적 승인자)을 지정하세요.
제출에 필요한 역할의 경우, 교수 조교와 같은 사용자가 성적 제출 프로세스를 시작하고 성적을 제출할 수 있도록 요구되는 수업 내 역할 및 기타 추가 교육기관 역할(예: 성적 제출자)을 지정하세요.
참고
이 설정은 제출자 워크플로우가 활성화되어 있을 때에만 표시됩니다.
접근 거부 메시지는 여기에 입력하면 안 되며; 사용자 정의 접근 거부 메시지는 이제 역할 구성 화면에서 입력해야 합니다.
결과 전송 설정
일반 통합 옵션
결과 전송 설정
파일명 마스크 필드에서 파일 추출 이름의 패턴을 설정하세요. 전송 유형이 결합된 파일로 설정된 경우, 파일 이름 앞에 ‘combined_’가 추가됩니다.
전송 방법을 선택하세요. 전송 방법 중 SFTP가 가장 일반적이며, 설정 방법은 다음 단계에서 다룹니다.
전송 유형를 선택하세요.
각 파일은 강좌별 단일 추출 파일을 개별적으로 전송합니다
통합 파일 결과는 하나의 파일로 구성되어 모든 강의 승인된 행을 포함하게 됩니다.
참고
수동 추출은 강좌별 추출 파일을 생성합니다.
Windows EOL이 필요한 Windows 환경에서 처리되는 경우 Windows EOL 사용을 활성화하십시오.
서버 필드에 SFTP 서버 URL 또는 IP를 입력하세요.
포트 필드에 SFTP 서버 포트를 입력하세요(보통 22).
사용자 이름 필드에 SFTP 사용자 이름을 입력하세요.
SFTP 암호를 비밀번호필드에 입력하세요.
경로 필드에 추출 파일의 경로를 입력하세요.
추출 파일 형식
추출 파일에 사용할 필드 구분자를 입력하세요. 기본값은 파이프( | )입니다.
필드 식별자를 입력하세요. 데이터가 구분자를 포함할 경우 사용할 문자를 지정합니다. 기본값은 큰따옴표( “ )입니다.
REST 통합 옵션
결과 전송 설정
게시 웹 서비스 엔드포인트 필드에서 성적을 게시할 엔드포인트를 지정하십시오.
최대 REST 레코드 필드에 하나의 트랜잭션에 포함될 최대 레코드 수를 입력하십시오.
나머지 보안 옵션
보안 REST API 활성화를 예로 선택합니다. 활성화된 경우 보안 메커니즘도 설정하십시오.
OAuth 1.0
공유 보안 비밀: OAuth 공유 보안 비밀을 입력하십시오
API 키: OAuth API 키를 입력합니다.
MAC 보안
MAC 보안에 대해 더 알아보기.
공유 비밀번호: 공유 비밀번호를 입력하세요
API 키: API 키를 입력하세요
타임스탬프 매개변수: 쿼리 문자열에서 타임스탬프 값을 나타내는 매개변수를 입력하세요
MAC 매개변수: 쿼리 문자열에서 MAC 값을 나타내는 매개변수를 입력하십시오
API 키 매개변수: 쿼리 문자열에서 API 키 값을 나타낼 매개변수를 입력하십시오
OAuth 2.0
Grades Journal은 설정된 엔드포인트의 REST 토큰 URL로 요청을 보냅니다. 인증 정보는 요청 헤더로 전송됩니다. Grant type은 client_credentials이며, 요청 본문에 다음과 같이 전송됩니다: grant_type: "client_credentials".
다음 필드를 입력하십시오:
REST 키: API 접근에 사용할 키를 입력하십시오
REST 비밀: API 접근에 사용될 비밀 값을 입력하십시오
REST 토큰 URL: 접근 토큰 요청을 위한 URL을 입력하세요
성적 인정 및 전이 설정
성적 인정 및 전환 설정
성과 열 또는 성적 수준에서 성적 승인을 활성화하려면 성적 승인 필요를 활성화하십시오. 이를 활성화하지 않으면 성적은 과정 수준에서만 승인될 수 있습니다.
성적 추출 버튼 활성화를 선택하여 승인자에게 성적 추출 버튼을 표시합니다. 성적서를 즉시 실행할 수 있습니다. 일반 통합의 경우 추출은 전송 유형이 "각 파일"로 설정된 경우에만 생성되고 전송됩니다.
참고
성적 추출 버튼은 성적 승인 담당자에게 항상 표시됩니다.
성적 제출 버튼 활성화를 선택하여 제출자에게 성적 제출 버튼을 표시합니다.
참고
제출자 워크플로우가 활성화되지 않은 경우, 이 확인란은 숨겨집니다.
제출자 워크플로가 활성화되어 있으면, '성적 제출' 버튼은 성적 승인 관리자에게 항상 보입니다.
제출된 성적에만 승인 승인 허용을 선택하여 제출 상태가 아닌 성적이 승인되거나 승인 취소되는 것을 방지합니다.
참고
제출자 워크플로우가 활성화되지 않은 경우, 이 확인란은 숨겨집니다.
승인된 성적만 추출 허용?을 선택하여 승인 상태가 아닌 성적의 추출을 방지합니다. 채점자가 승인 상태에 있지 않은 성적을 수동으로 추출하려고 시도하면 오류 메시지가 표시됩니다.
성적 승인 영역에서 교수가 계산된 열과 수동 열과 연관된 성적에서 사용할 수 있도록 해야 하는 경우 교수 피드백 사용을 선택합니다.
성적 승인 영역에서 고급 검색 링크를 교수들에게 표시해야 하며, 그들이 할당된 다른 과정을 검색할 수 있도록 해야 하는 경우 성적 승인자용 과정 검색 허용?을 선택합니다.
승인자가 승인 성적 버튼을 사용할 수 있도록 승인 성적 버튼을 표시해야 하는 경우 승인 성적 버튼 활성화?을 선택합니다.
참고
성적 승인 버튼은 성적 승인 관리자에게 항상 보입니다.
승인 거부는 선택 이유 메시지가 있는 경우에만 허용됩니까? 성적 승인 및 이전 도구에서 사유가 입력되지 않으면 성적이 승인되지 않게 하기 위해서입니다.
참고
제출자 워크플로가 활성화되어 있지 않으면 체크박스가 숨겨질 것입니다.
제출자와 승인자가 학년 수준에서만 작업을 수행할 수 있도록 성적 승인 작업을 과정 및 성적 열 수준에서 차단하려면 학년 수준으로 작업 제한을 선택합니다.
성적 승인 및 전송 도구를 과정 및 열 수준 승인 화면을 건너뛰고 바로 학년 수준으로 시작하려면 학년 수준으로 바로 시작을 선택합니다.
성적 승인 및 전송 도구를 과정 수준 승인 화면을 건너뛰고 바로 열 수준으로 시작하려면 열 수준으로 바로 시작을 선택합니다.
Select Launch directly to column level to launch the Grade Approval and Transfer Tool directly to the column level, bypassing the course level approval screen.
참고
If you choose both the Launch directly to grade level and the Launch directly to column level options, the Grade Approval and Transfer Tool will launch to the column level.
게시되지 않은 성적을 성적 추출에 포함하려면 게시되지 않은 성적 포함을 선택합니다. 여기에는 수동 열이나 점수가 덮어쓰여졌지만 아직 게시되지 않은 열은 포함되지 않습니다.
잘못된 성적이 제출, 승인 또는 추출되는 것을 방지하려면 성적 검증을 선택하여 일반 설정 섹션에 구성된 유효 성적을 기준으로 성적의 유효성을 검사합니다. 채점자가 잘못된 성적을 제출, 승인하거나 추출하려고 시도하면 오류 메시지가 표시됩니다.
등급 표시값 구성
성적 값을 표시하도록 승인 워크플로를 설정하세요:
성적 문자: 스키마 값이 문자일 경우 문자 등급을 반환하고, 그렇지 않으면 빈 문자열을 반환합니다.
스키마 값: 성적 열을 반환합니다. 기본 표시
퍼센트 점수: 계산된 퍼센트 점수를 반환합니다
보조 스키마 값: 성적 열에 대한 보조 표시를 반환합니다(원래 과정에만 적용)
점수 값: 점수 값을 반환합니다
학년센터 읽기 전용(원본)
다음 옵션은 Original 강좌 환경에만 적용됩니다. Ultra 강좌 환경에 사용할 수 있는 옵션은 다음 섹션 에서 다룹니다.
강좌 성적 센터를 잠그고 성적 접근을 시도하는 사용자를 읽기 전용 페이지로 리디렉션할 수 있습니다. 승인 잠금 의 경우 다음 옵션이 있습니다:
승인 즉시 : 해당 과목 성적이 승인되는 대로 성적 센터를 잠그십시오
성적 열의 마감일 이후: 선택한 성적 열의 마감일이 도달한 후 성적 센터를 잠금
참고
이 옵션을 선택하는 경우, '향상된 읽기 전용 기능'을 활성화해야 하며, 성적 센터가 잠길 시점을 결정하는 데 사용될 성적 열의 이름을 성적 열 이름 잠금 상자에 입력해야 합니다.
장애인: 성적 센터를 잠그지 마세요.
향상된 읽기 전용 기능 토글을 켜서 Original 코스를 위한 추가 읽기 전용 기능 설정을 구성합니다.
페이지 제목: 읽기 전용 페이지의 제목을 입력하세요
성적 열 이름 잠금: 성적 관리 센터에서 마감일을 기준으로 잠금 시기를 결정할 성적 열의 이름을 입력하세요
강좌 잠금 시간: 선택적으로, 잠금 작업이 실행될 시간을 입력하십시오. 시간이 입력되지 않으면, 해당 작업은 자정에 실행됩니다.
수동으로 잠금 해제된 코스 유지 시간: 수동으로 잠금 해제된 코스가 자동으로 다시 잠금되기 전에 잠금 상태를 유지할 수 있는 시간(시간 단위)을 선택적으로 입력할 수 있습니다
성적 센터 자동 잠금 시간(시간): 성적 승인 이벤트 후 성적 센터가 잠겨야 하는 시간(시간 단위)을 선택적으로 입력할 수 있습니다
잠금 승인 예외(시간): 승인 권한을 가진 역할은 잠금 이벤트 이후에도 성적 센터에 접근할 수 있는 시간(시간 단위)을 선택적으로 입력할 수 있습니다
승인 거부 예외(시간): 승인되지 않은 성적이 있어도 제출자 권한을 가진 역할이 잠긴 후 성적 센터에 접근할 수 있는 시간(시간 단위) 값을 선택적으로 입력할 수 있습니다
잠금 상태에 영향을 받지 않는 과목 역할: 성적 센터 읽기 전용 보기 페이지로 리디렉션되지 않고, 잠겨 있어도 전체 성적 이전 및 승인 페이지에 접근 가능한 과목 역할을 선택합니다.
참고
시스템 관리자는 전체 성적 이전 및 승인 페이지에 항상 접근할 수 있는 유일한 역할입니다.
성적 센터 읽기 전용(Ultra)
다음 옵션은 Ultra 강좌 환경에만 적용됩니다. Original 강좌 환경에서 사용할 수 있는 옵션은 이전 섹션에서 다룹니다.
강좌 성적 센터를 잠그고 성적 접근을 시도하는 사용자를 읽기 전용 페이지로 리디렉션할 수 있습니다. 승인 잠금 의 경우 다음 옵션이 있습니다:
승인 즉시 적용: 이 옵션은 울트라 리드 온리(Ultra Read-Only) 뷰에 적용되지 않습니다
성적 열의 마감일 이후: 선택한 성적 열의 마감일이 도달한 후 성적 센터를 잠금
참고
이 옵션을 선택하면 향상된 읽기 전용 기능이 활성화되며, 성적 센터가 잠기는 시점을 결정하는 데 사용되는 성적 열의 이름을 '성적 열 이름 잠금' 상자에 입력해야 합니다.
참고
잠금 작업이 완료되면 필요한 경우 코스를 잠금 해제할 수 있습니다. 잠금이 해제된 후에도 가능합니다.
장애인: 성적 센터를 잠그지 마세요.
향상된 읽기 전용 기능 토글을 켜서 Ultra 코스를 위한 성적 열 이름 잠금 및 코스 잠금 시간을 구성합니다.
성적 열 이름 잠금: 성적 관리 센터에서 마감일을 기준으로 잠금 시기를 결정할 성적 열의 이름을 입력하세요
강좌 잠금 시간: 선택적으로, 잠금 작업이 실행될 시간을 입력하십시오. 시간이 입력되지 않으면, 해당 작업은 자정에 실행됩니다.
참고
다른 향상된 읽기 전용 기능은 Ultra 강좌에는 적용되지 않습니다.
게재 위치 하나 이상 선택
LTI 배치를 명시하여 Original 및 Ultra 과정에서 성적 승인 및 이전 도구를 실행하는 데 사용하세요. 강사용 도구와 관리자용 도구는 필수적인 배치 장소입니다. 새 창에서 실행을 선택하면 LTI가 별도의 창에서 열립니다.
제출을 선택하여 모든 선택 사항을 저장합니다.