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