영어로 읽기

다음을 통해 공유


학교 데이터 동기화를 통해 액세스되는 OneRoster API 데이터

중요

학교 데이터 동기화를 사용하여 기관 데이터를 연결하고 사용할 수 있도록 하면 이 데이터를 Microsoft와 공유하고 organization 데이터 거버넌스 표준을 준수할 권한이 있음을 인정합니다.

OneRoster API(애플리케이션 프로그래밍 인터페이스)는 SIS(학생 정보 시스템) /SMS(학생 관리 시스템) 데이터를 교환하기 위해 1EdTech(이전 IMS Global)의 산업 표준 형식입니다. 이 동기화 방법을 사용하면 SIS/SMS 공급자가 개발한 REST 기반 OneRoster 1.1 API를 사용하여 SIS/SMS에 직접 연결할 수 있습니다. API 지원을 사용하면 CSV(쉼표로 구분된 값) 파일을 사용하는 대신 데이터를 직접 동기화할 수 있습니다.

OneRoster API를 통해 SIS/SMS에 연결할 때 액세스되는 데이터를 더 잘 이해할 수 있도록 다음 목록이 제공됩니다.

학교 데이터에 필요한 OneRoster API 엔드포인트

작업 URL 필수 필터 속성 선택적/권장 필터 예제
GetAllAcademicSessions /academicSessions 상태 dateLastModified /academicSessions?offset=0&limit=5000&filter=상태='active'/academicSessions?filter=dateLastModified>'{deltaDateTime}'
GetAllOrgs /orgs 상태 dateLastModified /orgs?offset=0&limit=5000&filter=상태='active'/orgs?filter=dateLastModified>'{deltaDateTime}'
GetAllUsers /사용자 상태 dateLastModified /users?offset=0&limit=5000&filter=상태='active'/users?filter=dateLastModified>'{deltaDateTime}'
GetAllClasses /클래스 상태 dateLastModified /classes?offset=0&limit=5000&filter=상태='active'/classes?filter=dateLastModified>'{deltaDateTime}'
GetAllEnrollments /등록 상태 dateLastModified /enrollments?offset=0&limit=5000&filter=상태='active'/enrollments?filter=dateLastModified>'{deltaDateTime}'

학교 데이터 동기화에 대한 선택적 API 엔드포인트

참고

인구 통계, 학생 연락처 관계 및 학생 사용자 플래그에 대한 선택적 데이터 조각의 경우 이 데이터를 포함하거나 포함하지 않는 기능은 SIS/SMS OneRoster 공급자 프로필에서 지원되는 선택적 데이터 기능을 기반으로 합니다. SIS/SMS 공급자가 이 데이터도 지원하는 경우 추가 데이터를 포함하기 위해 토글(기본값)이 기로 선택됩니다. 원하는 경우 해제할 토글을 선택할 수 있습니다. 토글을 사용할 수 없는 경우 표시되었지만 꺼져 있고 상호 작용에 사용할 수 없는 경우 공급자의 프로필이 현재 해당 데이터 제공을 지원하지 않습니다.

참고

공급자의 프로필에 인구 통계, 연락처 또는 사용자 인구 통계 플래그를 사용할 수 없음으로 표시하고 해당 기능을 지원하려는 경우 공급자에게 문의하고 SDS 가 데이터를 수집할 수 있도록 지원 추가를 요청하고 데이터가 지원하는 시나리오 및 환경을 사용하도록 설정할 수 있습니다. 

작업 URL 필수 필터 속성 선택적/권장 필터 예제
GetAllCourses /코스 상태 dateLastModified /courses?offset=0&limit=5000&filter=상태='active'/courses?filter=dateLastModified>'{deltaDateTime}'
GetAllDemographics /인구 통계 상태 dateLastModified /demographics?offset=0&limit=5000&filter=상태='active'/demographics?filter=dateLastModified>'{deltaDateTime}'