Skip to main content

승인 워크플로우 구성

승인 워크플로가 활성화되면 특정 일정에 따라 실행되어 승인된 성적이 자동으로 추출됩니다. 승인 워크플로에서 성적 추출 설정에 접근하려면 다음을 수행하십시오:

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

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

  3. Grade Export v2 메뉴에서 '설정 편집'을 선택하십시오.

  4. 열의APPROVAL_WORKFLOW 행에서 돋보기를 선택하세요.

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

  • 일반 설정 통합 형식 유형 설정, 추출 활성화, 일정 설정 및 유효 성적 표시

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

  • 성적 필터—승인 워크플로에 표시될 성적 열을 선택하세요

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

  • 강의 역할 설정—제출자 워크플로를 활성화하고 성적을 승인하거나 추출하거나 제출할 수 있는 역할을 할당하세요.

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

  • 성적 승인 및 이전 설정—승인 워크플로 옵션, 성적 표시, 읽기 전용 옵션, LTI 위치 설정

일반적인 배경

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

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

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

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

  2. CRON 스케줄은 승인된 성적 파일이 추출되는 빈도를 결정합니다. 활성화 모드를 켜시겠습니까? 지정된 CRON 스케줄에 따라 프로세스를 실행하려면 토글을 사용하고 추출 빈도를 정하는 CRON 표현식을 입력하세요.

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

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

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

    참고

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

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

학기 필터

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

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

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

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

열 필터

필터는 채점자가 등급을 확인하고 승인할 수 있도록 등급 열을 표시하는 데 사용됩니다. 한 가지 필터 옵션만 한 번에 활성화할 수 있습니다.

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

  • 외부 성적 열(원본) 또는 전체 성적(울트라) 전용 채점자에게 외부 성적 열(원본 강의)이나 전체 성적(울트라 강좌)만 표시하려면 이 체크박스를 선택하세요. 이 설정은 '열 필터' 설정과 '프로비저닝 활성화' 설정보다 우선합니다.

  • 프로비저닝 활성화 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. 제출자 워크플로우 활성화 토글을 켜면 성적 제출 워크플로우에 추가 단계가 포함됩니다(예: 조교가 성적을 제출하고 강사가 승인하는 경우).

  2. 승인이 필요한 역할에서는 사용자가 성적 승인 절차를 시작할 수 있도록 필요한 강의 역할(예: 강사)을 명시하십시오. 추가 교육기관 역할(예: 성적 승인자)이 성적 승인에 필요하다면 명시해 주세요. 사용자는 어떤 역할에서든 성적을 승인할 수 있습니다.

  3. 제출 필수 역할을 위해, 사용자가 성적 제출 승인 절차를 시작할 수 있도록 필요한 강의 역할(예: 조교)을 명시하세요. 추가 교육기관 역할(예: 성적 제출자)이 필요한 경우 명시해 주십시오. 사용자는 어떤 역할을 맡든 성적을 제출할 수 있습니다.

    참고

    이 설정은 제출자 워크플로우가 활성화되어 있을 때에만 표시됩니다.

  4. 접근 거부 메시지는 여기에 입력하면 안 되며; 사용자 정의 접근 거부 메시지는 이제 역할 구성 화면에서 입력해야 합니다.

결과 전송 설정

일반 통합 옵션

결과 전송 설정

  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

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

다음 필드를 입력하십시오:

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

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

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

성적 인정 및 전이 설정

성적 인정 및 전환 설정

  1. 성적 승인 필요를 활성화하면 열 또는 성적 수준에서 성적 승인을 할 수 있습니다. 해당 기능이 활성화되지 않을 경우, 성적은 과목 수준에서만 승인될 수 있습니다.

  2. 성적 추출 버튼이 활성화되었습니다. 선택 시 승인자에게 등급 추출 버튼이 표시됩니다. 그레이더들은 추출물을 즉시 분석할 수 있습니다. 통합의 경우 추출 방식은 각 파일에 전송 유형이 설정될 때에만 생성 및 전송됩니다.

    참고

    성적 추출 버튼은 성적 승인 담당자에게 항상 표시됩니다.

  3. 성적 제출 버튼이 활성화되었는지를 선택하세요. 제출자에게 성적 제출 버튼을 표시하려면.

    참고

    제출자 워크플로우가 활성화되지 않은 경우, 이 확인란은 숨겨집니다.

    제출자 워크플로가 활성화되어 있으면, '성적 제출' 버튼은 성적 승인 관리자에게 항상 보입니다.

  4. 제출된 성적에 대해서만 승인 허용을 선택하여 제출된 성적과 다른 상태의 성적이 승인되지 않도록 하세요.

    참고

    제출자 워크플로우가 활성화되지 않은 경우, 이 확인란은 숨겨집니다.

  5. Select Only allow extract for approved grades? to prevent grades that are not in the Approved status from being extracted. If a grader tries to manually extract grades that are not in the Approved status, they will receive an error message.

  6. 강사 피드백 활성화 계산 및 수동 평가 열과 관련된 성적을 강사가 성적 승인 영역에서 확인할 수 있어야 한다면.

  7. '성적 승인자에게 강좌 검색 허용'을 선택하세요. '고급 검색' 링크가 성적 승인 영역에 있어 강사가 배정된 다른 과목을 검색할 수 있도록 해야 합니다.

  8. 성적 승인 버튼이 활성화되어 있습니까? 승인자가 성적 승인 버튼을 볼 수 있도록 .

    참고

    성적 승인 버튼은 성적 승인 관리자에게 항상 보입니다.

  9. 승인 거부는 선택 이유 메시지가 있는 경우에만 허용됩니까? 성적 승인 및 이전 도구에서 사유가 입력되지 않으면 성적이 승인되지 않게 하기 위해서입니다.

    참고

    제출자 워크플로가 활성화되어 있지 않으면 체크박스가 숨겨질 것입니다.

  10. 아동 과목 접근 제한은 제출자 또는 승인자만 볼 수 있도록 설정 선택하면 지정된 아동 과목의 학년 학생만 볼 수 있게 제한됩니다.

  11. 학년 수준으로 제한을 선택하면 과목 및 성적 열에 있는 모든 성적 승인 조치가 방지됩니다. 제출자와 승인자는 학년 수준에서만 조치를 취할 수 있습니다.

  12. 학년 수준으로 바로 출시 설정은 승인 워크플로의 다가오는 기능이기 때문에 선택하면 안 됩니다.

  13. 게시되지 않은 성적을 선택하여 성적 추출 시 게시되지 않은 성적이 포함되도록 하세요. 여기에는 수동으로 덮인 열과 등급은 포함되어 있지만 아직 게시되지 않은 열은 포함되어 있지 않습니다.

  14. Select Validate Grades to prevent invalid grades from being submitted, approved, or extracted, based on the valid grades that are configured in the General Settings section. If a grader tries to submit, approve, or extract invalid grades, they will receive an error message.

등급 표시값 구성

성적 값을 표시하도록 승인 워크플로를 설정하세요.

  • 성적 문자: 스키마 값이 문자일 경우 문자 등급을 반환하고, 그렇지 않으면 빈 문자열을 반환합니다.

  • 스키마 값: 성적 열을 반환합니다. 기본 표시

  • 퍼센트 점수: 계산된 퍼센트 점수를 반환합니다.

  • 보조 스키마 값: 성적 열에서 반환된 보조 표시(원본 과목에만 적용)

  • 점수 값: 점수 값을 반환합니다.

학년센터 읽기 전용(원본)

다음 옵션은 오로지 원래 과정 경험에만 적용됩니다. 옵션은 다음 섹션에서 울트라 코스 경험을 다루고 있습니다.

강좌 성적 센터를 잠그고 성적 접근을 시도하는 사용자를 읽기 전용 페이지로 리디렉션할 수 있습니다. 승인 시 잠금의 경우 다음 세 가지 옵션 중 하나를 선택하십시오.

  • 승인 즉시 : 해당 과목 성적이 승인되는 대로 성적 센터를 잠그십시오.

  • 성적 열의 마감일 이후: 선택한 성적 열의 마감일이 도달한 후 성적 센터를 잠금.

    참고

    이 옵션을 선택하는 경우, '향상된 읽기 전용 기능'을 활성화해야 하며, 성적 센터가 잠길 시점을 결정하는 데 사용될 성적 열의 이름을 '성적 열 잠금 이름' 상자에 입력해야 합니다.

  • 장애인: 성적 센터를 잠그지 마세요.

향상된 읽기 전용 기능을 켜 원본 강의에 대한 추가 읽기 전용 기능을 설정하세요.

  • 페이지 제목: 읽기 전용 페이지의 제목을 입력하세요

  • 성적 열 잠금 이름: 성적 센터가 잠길 시점을 결정하는 데 사용될 성적 열의 이름을 입력하십시오.

  • 강좌 잠금 시간: 선택적으로, 잠금 작업이 실행될 시간을 입력하십시오. 시간이 입력되지 않으면, 해당 작업은 자정에 실행됩니다.

  • 수동으로 잠금 해제된 코스 유지 시간: 수동으로 잠금 해제된 코스가 자동으로 다시 잠금되기 전에 잠금 상태를 유지할 수 있는 시간(시간 단위)을 선택적으로 입력할 수 있습니다.

  • 성적 센터 자동 잠금 시간(시간): 성적 승인 이벤트 후 성적 센터가 잠겨야 하는 시간(시간 단위)을 선택적으로 입력할 수 있습니다.

  • 잠금 승인 예외(시간): 승인 권한을 가진 역할은 잠금 이벤트 이후에도 성적 센터에 접근할 수 있는 시간(시간 단위)을 선택적으로 입력할 수 있습니다.

  • 승인 거부 예외(시간): 승인되지 않은 성적이 있어도 제출자 권한을 가진 역할이 잠긴 후 성적 센터에 접근할 수 있는 시간(시간 단위) 값을 선택적으로 입력할 수 있습니다.

  • 잠금 상태에 영향을 받지 않는 과목 역할: 성적 센터 읽기 전용 보기 페이지로 리디렉션되지 않고, 잠겨 있어도 전체 성적 이전 및 승인 페이지에 접근 가능한 과목 역할을 선택합니다.

    참고

    시스템 관리자는 전체 성적 이전 및 승인 페이지에 항상 접근할 수 있는 유일한 역할입니다.

학년센터 읽기 전용(울트라)

울트라 코스 경험에만 적용되는 다음 옵션입니다. 섹션 에서 원본 과정 경험에 대한 옵션을 다루고 있습니다.

강좌 성적 센터를 잠그고 성적 접근을 시도하는 사용자를 읽기 전용 페이지로 리디렉션할 수 있습니다. 승인 잠금 의 경우 다음 옵션이 있습니다:

  • 승인 즉시 적용: 이 옵션은 울트라 리드 온리(Ultra Read-Only) 뷰에 적용되지 않습니다.

  • 성적 열의 마감일 이후: 선택한 성적 열의 마감일이 도달한 후 성적 센터를 잠금.

    참고

    이 옵션을 선택하면 향상된 읽기 전용 기능이 활성화되며, 성적 센터가 잠기는 시점을 결정하는 데 사용되는 성적 열의 이름을 '성적 열의 이름 잠금' 상자에 입력해야 합니다.

    참고

    잠금 작업이 완료되면 필요한 경우 코스를 잠금 해제할 수 있습니다. 잠금이 해제된 후에도 가능합니다.

  • 장애인: 성적 센터를 잠그지 마세요.

향상된 읽기 전용 기능을 켜서 울트라 과목의 성적 열람 잠금 및 강좌 잠금을 설정하세요.

  • 성적 열 잠금 이름: 성적 센터가 잠길 시점을 결정하는 데 사용될 성적 열의 이름을 입력하십시오.

  • 강좌 잠금 시간: 선택적으로, 잠금 작업이 실행될 시간을 입력하십시오. 시간이 입력되지 않으면, 해당 작업은 자정에 실행됩니다.

참고

울트라 코스에는 다른 향상된 읽기 전용 기능이 적용되지 않습니다.

하나 이상의 배치를 선택하십시오.

LTI 배치를 명시하여 Original 및 Ultra 과정에서 성적 승인 및 이전 도구를 실행하는 데 사용하세요. 강사용 도구와 관리자용 도구는 필수적인 배치 장소입니다. 새 창에서 실행을 선택하면 LTI가 별도의 창에서 열립니다.

제출을 선택하여 모든 선택지를 저장하십시오.