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