첨부파일 검색 iframe은 클래스룸 과제를 만들 때 부가기능을 열 때 교사에게 표시되는 초기 뷰입니다. 첨부파일은 학생이 상호작용할 콘텐츠 또는 활동입니다.
교사가 클래스룸 과정 내에서 새 게시물 (예: 과제, 공지사항, 질문)을 만들고 부가기능 드롭다운 목록에서 부가기능을 선택합니다. 짧은 시간 동안 (몇 시간 단위) 클래스룸에서 부가기능이 게시물에 첨부파일을 추가할 수 있습니다.
그림 1. 교사가 첨부할 수 있는 부가기능 옵션을 포함하여 과제 생성 뷰
교사가 부가기능을 선택하면 클래스룸에서 첨부파일 검색 iframe을 만들고 부가기능의 실행 URL을 로드합니다. 관련 iframe 쿼리 매개변수는 실행 URL에 전달됩니다.
그림 2. iframe의 첨부파일 검색 UI의 예
교사는 iframe 내에서 파트너의 웹 애플리케이션을 사용하여 첨부파일을 선택합니다. 앱에서 Classroom API를 호출하여 첨부파일을 과제에 첨부합니다. 교사가 첨부파일 선택을 완료하면 부가기능에서 iframe 닫기를 요청하는 postMessage 페이로드를 전송합니다.
iframe이 닫히고 선생님은 이제 첨부파일을 미리 보거나 과제에서 삭제하도록 선택할 수 있습니다.
그림 3. 세 가지 활동 유형의 부가기능 연결이 있는 과제 생성 뷰
iframe 내 UX 고려사항
- 부가기능을 처음 열면 교사에게 로그인하라는 메시지가 표시되어야 합니다.
- 모든 Classroom API 호출에는 Google 싱글 사인온이 필요합니다. 제품에 별도의 로그인 시스템이 있는 경우 계정을 연결해야 합니다.
- 교사는 최종 선택을 하기 전에 iframe 내에서 첨부파일을 미리 볼 수 있어야 합니다.
- 교사는 첨부 가능한 콘텐츠를 검색하거나 둘러볼 수 있어야 합니다.
- 부가기능은 최근 콘텐츠, 내 콘텐츠, 학습 기술별 필터와 같은 다양한 뷰를 제공할 수 있습니다.
- 부가기능은 iframe 내에서 연결 가능한 새 항목을 만들 수 있는 기능을 제공해야 합니다.
UX 요구사항에 관한 자세한 내용은 클래스룸 부가기능 요구사항 체크리스트를 참고하세요.
iframe 내에 라이선스 상태 표시
부가기능에 라이선스가 필요하지만 교사에게 없는 경우 상황을 해결하기 위한 적절한 다음 단계를 안내하는 명확한 메시지를 교사에게 제공해야 합니다. 이는 라이선스 제한으로 인해 발생할 수 있는 혼란을 방지하기 위한 것입니다.
또한 부가기능은 다음을 충족해야 합니다.
- 첨부파일 검색 iframe 내에 교사의 라이선스 수준을 표시합니다.
- 라이선스 수준의 제한으로 인해 교사가 사용할 수 없는 콘텐츠를 숨기거나 사용 중지합니다.