강좌 사용자는 강의 과정에 등록 된 모든 학생 (만)의 목록을 가져 오기 위해 Valence Learning Framework API를 호출해야합니까?강사는 내 과정에 등록한 학생 목록을 어떻게 만듭니 까?
답변
D2L LE 클래스 조직 단위에 등록 된 사람 목록을 얻는 데는 두 가지 주요 방법이 있습니다. 시스템이 구성한
-
이 모든 사용자를 검색합니다
GET /d2l/api/le/{ver}/{orgUnitId}/classlist/
는 조직 단위에 등록 : 당신이 사용해야 호출 권리는 백 엔드에 작업중인 LMS의 구성을 대부분을 의존 수업에 출연한다. 일부 조직에서는 학생으로 만 구성 될 수 있지만 대부분이 호출은 강사, 교사 및 학생과 학생이 섞여있을 가능성이 큽니다. 그래서 이것은 여러분의 필요에 부응 할 수도 있고 그렇지 않을 수도 있습니다.
과정에서 다른 학생과 구별하기 위해이 경로와 함께 시도 할 수있는 한 가지는 학년 인 사람들에 초점을 맞추는 것입니다. 클래스 목록을 호출 한 다음 클래스 목록의 각 사용자에 대해 알려진 등급 항목의 등급 값을 요청하십시오. 사용자가 코스에 참여하고 점수를 매기는 학생 또는 다른 역할 인 경우 두 번째 전화에서 알 수 있습니다. 비 학년 사용자는 등록과 관련된 등급 값을 갖지 않습니다. 이것은 등록 된 역할의 세부 사항에 집중하지 않고도 코스에 등록한 사람의 측면에 초점을 맞출 수 있도록 도와줍니다 (일부 조직에서는 역할 정보를 중요하게 취급합니다).
GET /d2l/api/lp/{ver}/enrollments/orgUnits/{orgUnitId}/users/?roleId={roleId}
이 호출은 모든 사용자가 조직 단위에 등록 검색합니다, 당신은 역할 ID에 의해 검색된 목록을 필터링 할 수 있습니다 (그래서 당신은 자신의 역할 ID로, 전용 "학생"사용자를 나열 할 수 있습니다). 조직에 여러 종류의 학생 역할이있는 경우 가능한 모든 학생 역할을 가져올 수 있도록 알 필요가 있습니다. 또는
roleId
쿼리 매개 변수없이 간단하게 전화를 걸고 되돌릴 포함 된 역할 정보를 기반으로 가져온 후 결과를 필터링 할 수 있습니다.그러나 강사 사용자에게는이 통화에 필요한 권한이 없을 수 있습니다. 일부 조직에서는 이와 같이 등록 정보 호출에 대한 액세스를 관리 사용자에게만 제한합니다.
참고 해당 사용자가 학생 것, 기본적으로 만 20 항목 반환 여부를 결정하기 위해 학년 객체 메소드를 사용하여. 호출시 pageSize 매개 변수를 지정하여 재정의 할 수 있지만 적절한 권한이없는 경우 동일한 권한 문제로 실행될 수 있습니다.