SITS 통합을 사용하여 Grades Journey 구현

  1. 시스템 관리자의 Blackboard 빌딩 아래에서 빌딩 블록을 선택합니다.
  2. 설치된 도구를 선택합니다.
  3. Blackboard Grade Journey 서비스를 찾고 설정을 선택합니다.
  4. 아래 섹션을 사용하여 각 설정 그룹 아래에서 속성을 구성합니다.

과제 및 성적 열 설정(수신 데이터)

다음 속성을 구성합니다.

  • 작업 예약
    • 작업 상태 설정 - 비활성화됨을 선택합니다.
    • CRON 예약 - 해당 없음
    • 콘텐츠 영역 프로비저닝 - 채점할 수 있는 항목을 생성할 기본 폴더를 선택합니다(트랜잭션에서 덮어쓰지 않는 경우에 한함).
    • 콘텐츠 항목 프로비저닝 확인 - 이 설정은 프로비저닝된 콘텐츠 항목에 대해 일치하는 규칙을 정의합니다. 옵션은 다음과 같습니다.
      • 제한 없음: 항상 피드의 항목을 새 콘텐츠 항목으로 추가합니다.
      • 한 번만: 지정된 항목을 한 번만 추가합니다(LIS용으로 사용됨).
      • 이름을 기준으로 일치하는 항목 업데이트: 첫 번째 전달 시 항목을 추가하고, 후속 가져오기를 수행할 때 콘텐츠 항목 제목을 기준으로 일치하는 항목을 기반으로 이를 업데이트합니다.
    • 채점할 수 있는 항목 프로비저닝 확인 - 이 설정은 프로비저닝된 콘텐츠 항목의 결과로 생성된 성적 열 또는 프로비저닝된 수동 성적 열에 대해 일치하는 규칙을 정의합니다. 옵션은 다음과 같습니다.
      • 이름을 기준으로 일치하는 항목 업데이트: 첫 번째 전달 시 항목을 추가하고, 후속 가져오기를 수행할 때 콘텐츠 항목 제목을 기준으로 일치하는 항목을 기반으로 이를 업데이트합니다.
      • 메타데이터를 기준으로 일치하는 항목 업데이트: 첫 번째 전달 시 항목을 추가하고, 후속 가져오기를 수행할 때 항목 입력 데이터 기록의 데이터 목록(선택 사항)에 포함된 "유형"이라는 메타데이터 특성에 저장되어 있는 값이 일치하는 항목을 기반으로 이를 업데이트합니다.
  • 결과 전송 설정, 파일 형식, 성적 열 설정은 REST에 적용되지 않습니다.

완료되면 제출을 선택합니다.

성적 추출 설정(발신 데이터)

다음 속성을 구성합니다.

  • 통합
    • 통합 유형 - SITS 통합을 선택합니다. SITS 통합을 수행하면 그 결과로 3개의 발신 파일, 즉 요약, 평가 파일 및 재평가 파일이 생성됩니다.
    • CRON 예약 - 백그라운드에서 추출이 발생하는 빈도를 선택합니다. 예를 들어 이 값이 0 0/60 * 1/1 * ? *로 설정된 경우에는 1시간마다 추출이 발생합니다.
    • 어림수 - 점수의 최대 소수 자릿수를 선택합니다.
    • 표시하지 않은 평가의 값 추출 - 표시하지 않았거나 채점하지 않은 항목을 반환하려면 Null 값을 선택합니다.
    • 열 필터 - 프로비저닝이 비활성화되어 있을 때 승인 및 추출 열 목록을 쉼표로 구분된 특정한 성적 열 이름 목록으로 제한해야 하는 경우 이 옵션을 선택합니다. 이 설정을 사용하면 보고해야 할 열만 추출할 수 있습니다.
    • 외부 성적 열만 - 승인 및 추출 열 목록을 코스 외부 성적 열 즉, 외부 성적으로 표시된 성적관리센터의 열로 제한해야 하는 경우 이 옵션을 선택합니다.

      이 설정은 열 필터링 설정보다 우선적으로 적용됩니다.

    • 프로비저닝 활성화됨 - 승인 및 추출 열 목록을 학생 정보 시스템에서 프로비저닝된 콘텐츠 항목 및 채점할 수 있는 항목의 일부로 가져온 열로 제한해야 하는 경우 이 옵션을 선택합니다.
    • 열 매핑 - 파이프 기호로 구분된 이름/값 쌍의 목록을 입력하여 보고서에서 각 기록용으로 포함할 성적 열 데이터 필드를 식별합니다. 이 설정을 비워 두면 보고서에 필드의 기본 목록이 포함됩니다.
      EXTERNAL_COURSE_KEY|STUDENT_ID|BATCH_UID|TITLE|MARK|GRADE|EXTENDED_DATA
  • 코스 내 역할 요구 사항 추출
    • 코스 내 역할 - 사용자가 성적을 승인하는 데 필요한 코스 내 역할(예: 교수자)을 지정합니다.
    • 교육기관 내 역할 - 사용자가 성적을 승인하는 데 필요한 교육기관 내 역할(예: 성적 승인자)을 지정합니다.
    • 접근 거부됨 메시지 - 적절한 권한 없이 성적을 추출하려고 시도하는 사용자에게 표시할 메시지를 입력합니다.
  • 결과 전송 설정
    • PostWebservice 엔드포인트 - 성적 게시물에 대한 엔드포인트를 지정합니다.
    • TestingRestWebservice 엔드포인트 - 이 설정을 무시합니다(일반).
  • REST (발신) 보안 설정
    • 보안 REST API 활성화 - 엔드포인트가 보안을 구현할 경우 이 설정을 활성화합니다. 이 설정을 활성화하는 경우 다음 항목도 설정하십시오.
      • 공유 암호 - 공유 키를 입력합니다.
      • API 키 - API 키를 입력합니다.
      • 타임스탬프 범위 - 설정하지 않습니다.
      • 타임스탬프 매개변수 - 타임스탬프의 매개변수를 입력합니다.
      • MAC 매개변수 - MAC 매개변수를 입력합니다.
      • API 키 매개변수 - API 키 매개변수를 입력합니다.
  • 성적 승인 및 전송 설정
    • 성적 승인 필요 - 성적을 열 또는 성적 수준에서 승인하려는 경우 이 설정을 활성화합니다.
    • 내역 페이지 표시 여부 - 성적 수준 승인을 수행하지 않고 코스에서 추출할 때 내역 페이지를 표시하려는 경우 이 설정을 활성화합니다.
    • 추출 수행 버튼 활성화 여부 - 채점자가 즉시 추출을 실행하도록 허용하려면 이 설정을 활성화합니다.
    • 추출 예약 버튼 활성화 여부 - 채점자가 추출을 예약/승인하도록 허용하려면 이 설정을 활성화합니다.
    • 승인 시 잠금 여부 - 성적관리센터를 읽기 전용으로 전환하여 추출 이후에 성적을 수정할 수 없게 하려면 이 설정을 활성화합니다.

완료되면 제출을 선택합니다.

통지 설정

원하는 경우 '설정' 메뉴로 돌아가 통지 설정을 수정합니다.

REST API 보안 설정(수신 데이터 보안)

다음 속성을 구성합니다.

  • REST 발신 보안 설정
    • 보안 REST API 활성화 - 수신 엔드포인트가 보안을 구현할 경우 이 설정을 활성화합니다.
    • IP 필터 - 모든 수신 IP에 대해 필터를 활성화합니다. 이 설정을 활성화하는 경우 다음 항목도 설정합니다.
      • 공유 암호 - 공유 키를 입력합니다.
      • API 키 - API 키를 입력합니다.
      • 타임스탬프 범위 - 설정하지 않습니다.
      • 타임스탬프 매개변수 - 타임스탬프의 매개변수를 입력합니다.
      • MAC 매개변수 - MAC 매개변수를 입력합니다.
      • API 키 매개변수 - API 키 매개변수를 입력합니다.

완료되면 제출을 선택합니다.

로깅 수준

다음 속성을 구성합니다.

  • 로깅 구성
    • 로그 상세 표시 수준 - 로깅 수준을 결정하려면 이 설정을 /logs/custom/bbc-GradeyJourney.log 파일로 구성합니다. 기본값은 INFO이지만 문제 해결을 위해 DEBUG를 추가할 수도 있습니다. 디버깅하지 않는 한 프로덕션 구성은 INFO로 설정해야 합니다.

유효성 검사 테스트 실행

  1. 시스템 관리자 > 성적 추출 설정(발신 데이터)으로 이동합니다.
  2. 전송 방법을 로컬로 업데이트하고 Blackboard Learn을 실행 중인 사용자가 읽고, 업데이트하고, 삭제할 수 있는 로컬 폴더로 경로를 설정합니다. 필요에 따라 SITS 통합을 선택합니다. 제출을 선택합니다.
  3. 설정에서 과제 및 성적 열 설정(수신 데이터)을 선택합니다.
  4. 'FTP를 통해 입력 파일 수신'을 '비활성화됨'으로 업데이트하고 Blackboard Learn을 실행 중인 사용자가 읽고, 업데이트하고, 삭제할 수 있는 로컬 폴더로 경로를 설정합니다. 제출을 선택합니다.
  5. 플랫 파일을 사용하여 코스에서 가중치가 적용된 성적 열을 생성합니다. 등록을 위해 사용자 파일을 생성합니다.
  6. Learn에 교수자로 로그인하고 코스로 이동합니다.
  7. 성적관리센터로 이동합니다. 이 위치에 가중치가 적용된 새 성적 열이 나타나야 합니다.
  8. 과제를 생성하고 가중치가 적용된 열에 100%로 매핑합니다.
  9. 등록을 위해 성적을 입력합니다.
  10. 관리 메뉴에서 성적 승인 및 전송을 선택합니다.
  11. 코스, 성적 열 또는 성적 수준에서 추출 및 예약 버튼을 선택합니다.
  12. 추출이 완료되면 하나 이상의 파일이 추출 폴더에 나타납니다.
  13. 추출에 실패하는 경우 <bb home>/custom/log/bbgs-GradeJourney.log에 있는 로그를 참조하십시오.