첨부파일 검색 iframe

첨부파일 검색 iframe은 클래스룸 작업을 만드는 동안 부가기능을 열 때 교사가 표시되는 초기 보기입니다. 연결은 학생들이 상호작용하도록 하려는 콘텐츠나 활동입니다.

클래스룸 강의 내에서 교사는 새 게시물 (예: 과제, 공지사항, 질문)을 만들고 부가기능 드롭다운 목록에서 부가기능을 선택합니다. 짧은 시간 동안 (몇 시간 단위) 클래스룸에서 부가기능이 게시물에 첨부파일을 추가할 수 있습니다.

교사가 첨부할 수 있는 부가기능 옵션을 포함한 과제 생성 화면 그림 1. 교사가 첨부할 수 있는 부가기능 옵션이 포함된 과제 생성 보기

교사가 부가기능을 선택하면 클래스룸은 첨부파일 검색 iframe을 만들고 부가기능의 실행 URL을 로드합니다. 관련 iframe 쿼리 매개변수가 실행 URL에 전달됩니다.

첨부파일 검색 UI의 예

그림 2. iframe에 있는 첨부파일 검색 UI의 예

교사는 iframe 내에서 파트너의 웹 애플리케이션을 사용하여 첨부파일을 선택합니다. 앱은 클래스룸 API를 호출하여 과제에 첨부파일을 첨부합니다. 교사가 첨부파일 선택을 마치면 부가기능에서 postMessage 페이로드를 전송하여 iframe 닫기를 요청합니다.

iframe이 닫히고 선생님은 이제 첨부파일을 미리 보거나 과제에서 삭제하도록 선택할 수 있습니다.

과제 생성 보기

그림 3. 세 가지 활동 유형의 부가기능 연결이 있는 과제 생성 뷰

iframe 내 UX 고려사항

  • 부가기능을 처음 열면 교사에게 로그인하라는 메시지가 표시되어야 합니다.
  • 모든 Classroom API 호출에 Google 싱글 사인온(SSO)이 필요합니다. 제품에 별도의 로그인 시스템이 있으면 계정을 연결해야 합니다.
  • 교사는 최종 선택을 하기 전에 iframe 내에서 첨부파일을 미리 볼 수 있어야 합니다.
  • 교사는 첨부 가능한 콘텐츠를 검색하거나 찾아볼 수 있어야 합니다.
  • 부가기능은 최근 콘텐츠, 내 콘텐츠와 같은 다양한 뷰를 제공하고 학습 기술별로 필터링할 수 있습니다.
  • 부가기능은 iframe 내에서 연결 가능한 새 항목을 만드는 기능을 제공해야 합니다.

UX 요구사항에 관한 자세한 내용은 클래스룸 부가기능 요구사항 체크리스트를 참고하세요.

iframe 내에 라이선스 상태 표시

부가기능에 라이선스가 필요하지만 교사에게 없는 경우 상황을 해결하기 위한 적절한 다음 단계를 알리는 명확한 메시지를 교사에게 제공해야 합니다. 이는 라이선스 제한으로 인해 발생할 수 있는 혼란을 방지하기 위한 것입니다.

부가기능에서 다음 사항도 권장합니다.

  • 첨부파일 검색 iframe 내에 교사의 라이선스 수준을 표시합니다.
  • 라이선스 수준의 제한으로 인해 교사가 사용할 수 없는 콘텐츠를 숨기거나 사용 중지합니다.