OneRoster® 1.1 API를 사용하여 학교 데이터 동기화(클래식)를 배포하는 방법

중요

학교 데이터 동기화(클래식) 환경은 2024년 말까지 새로운 학교 데이터 동기화 환경 으로 대체됩니다. 내년에 학교로 돌아가기를 위한 새로운 환경으로 의 전환을 계획 하는 것이 좋습니다.

OneRoster®는 SIS(학생 정보 시스템) 데이터를 교환하기 위한 업계 표준 형식입니다. OneRoster® REST API는 SDS(클래식) 서비스를 통해 OneRoster® API를 Microsoft 365에 제공하는 SIS의 개체를 동기화할 수 있는 수단입니다. 이 동기화 방법을 사용하면 SIS에서 제공하는 REST 기반 OneRoster 1.1 API를 사용하여 SIS에 직접 연결하고 CSV 파일을 사용하는 대신 데이터를 직접 동기화할 수 있습니다. OneRoster® API를 사용하여 강조 표시된 데이터 범주를 수집하면 프로비저닝을 위한 핵심 SDS(클래식) 기능을 점등할 수 있습니다. 또한 나열된 Microsoft 365(Microsoft 365) 제품 및 기능에 대한 환경을 향상시킬 수 있습니다.

OneRoster® Sync 메서드를 사용하여 SDS(클래식)를 설정하려면 이 문서에 설명된 지침을 따릅니다.

필수 구성 요소

OneRoster® Sync 메서드를 사용하여 SDS(클래식)와 동기화를 시작하기 전에 SDS 개요(클래식) 를 읽고 다음 필수 구성 요소를 충족하는지 확인합니다.

• 교육용 Office 365 테넌트
• 전역 관리 권한

참고

SDS(클래식)를 통해 제공하는 데이터는 해당 앱을 통해 타사 애플리케이션 공급자가 액세스할 수 있으므로 이러한 타사에서 사용할 수 있도록 하려는 데이터만 동기화해야 합니다.

배포 비디오 보기

또한 사용자 ID 일치는 다음 비디오를 참조하세요.

• 비디오: 동기화를 위해 원본 및 대상 특성을 일치시킬 수 있는 방법

학교 데이터 동기화에서 액세스하는 데이터(클래식)

중요

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

교육 세션

작업	URL	필수 필터 속성	예
getAllAcademicSessions	/academicSessions	schoolYear, 상태	/academicSessions?filter=schoolYear='2019' AND 상태='active'
getAcademicSession	/academicSessions/{academicSession_id}

사용자

작업	URL	필수 필터 속성	예
getAllUsers	/사용자	상태, dateLastModified	/users?filter=상태='active' AND dateLastModified'2018-01-25T03>:22:03.297Z'
getUser	/users/{user_id}

학교

작업	URL	필수 필터 속성	예
getAllSchools	/학교	상태, dateLastModified	/users?filter=상태='active' AND dateLastModified'2018-01-25T03>:22:03.297Z'
getSchool	/schools/{school_id}
getClassesForSchool	/schools/{school_id}/클래스	상태, dateLastModified	/schools/{school_id}/classs?filter=dateLastModified'2018-01-25T03>:22:07.209Z'
getStudentsForSchool	/schools/{school_id}/students	상태, dateLastModified	/schools/{school_id}/students?filter=dateLastModified'2018-01-25T03>:22:07.209Z'
getTeachersForSchool	/schools/{school_id}/teachers	상태, dateLastModified	/schools/{school_id}/teachers?filter=dateLastModified'2018-01-25T03>:22:07.209Z'
getEnrollmentsForSchool	/schools/{school_id}/등록	상태, dateLastModified, role	/schools/{school_id}/enrollments?filter=role='student'/schools/{school_id}/enrollments?filter=dateLastModified'2018-01-25T03>:22:28.204Z' AND role='teacher'

클래스

작업	URL	필수 필터 속성	예
getClass	/classes/{class_id}

등록

작업	URL	필수 필터 속성	예
getEnrollment	/enrollments/{enrollment_id}

학생

작업	URL	필수 필터 속성	예
getStudent	/students/{student_id}

교사

작업	URL	필수 필터 속성	예
getTeacher	/teachers/{teacher_id}

용어

작업	URL	필수 필터 속성	예
getTerm	/terms/{term_id}

Microsoft Entra Connect 배포 경고 정보

Microsoft Entra Connect를 통해 온-프레미스 Active Directory에서 동기화되는 테넌트용 SDS(클래식)를 구성하는 경우 잘못된 연결 끊김에 표시되는 연결 끊김 수가 증가할 수 있습니다. 이는 Microsoft 365 그룹이 Microsoft Entra Connect Metaverse 및 온-프레미스 Active Directory에 다시 동기화할 수 없는 결과입니다. 이러한 경고는 현재 Microsoft Entra Connect 배포에 부정적인 영향을 주지 않으며 결과 동기화 실패에 대한 정보만 제공합니다. SDS(클래식)에서 동기화를 사용하도록 설정한 후 Microsoft Entra Connect에서 이러한 경고가 표시되어야 합니다. SDS(클래식)를 통해 동기화되는 각 클래스에 대해 하나의 Microsoft 365 그룹이 만들어집니다.

OneRoster API 동기화 방법을 사용하여 SIS 데이터 동기화

SIS/SMS 액세스를 설정한 후 SDS(클래식)에서 동기화 프로필을 만들어 정보를 동기화합니다.

SDS 액세스 및 처음 로그인

SDS 관리 포털에 액세스하려면 프라이빗 웹 브라우저를 시작하고 sds.microsoft.com 이동한 다음 Microsoft 365 Global 관리 계정을 사용하여 로그인합니다.

동기화 프로필 만들기 및 SIS 데이터 동기화

1. 로그인한 후 왼쪽 탐색 영역에서 +프로필 추가 를 선택하여 동기화 프로필을 만듭니다.

   

2. 연결 유형 선택 페이지에서 OneRoster API를 선택한 다음, "공급자 선택" 드롭다운 메뉴에서 SIS 통합 공급자를 선택합니다. 완료되면 시작을 선택합니다.

   

   • 이 프로필 이름 지정 - 동기화 프로필의 이름을 입력합니다. 이 이름은 SDS(클래식) 대시보드에서 동기화 프로필을 식별하는 데 사용되며 프로필 설정이 완료되면 변경할 수 없습니다.
   • 동기화 방법 선택 - 표시된 사용 가능한 동기화 방법 중에서 선택합니다. OneRoster를 사용하여 동기화하는 경우 API 동기화 방법을 통해 연결을 선택한 다음, 서비스 선택에 대해 OneRoster 1.1 API를 선택합니다.

3. 동기화 옵션 페이지에서 적절한 옵션을 선택하여 새 사용자를 만들거나 기존 사용자를 동기화합니다. 그런 다음, 페이지에서 적절한 선택을 완료합니다.

   참고

   새 사용자를 만들기 위한 옵션을 사용하여 실행하고 V2.1 CSV를 채택하려는 경우 학교로 돌아가기 위한 전환의 일환으로 V2.1 CSV 형식을 지원할 준비를 하는 데 도움이 되는 도구를 릴리스했습니다. 사용자를 만들기 전에 앵커 ID 업데이트를 참조하세요.

   

   • 기존 사용자 - OneRoster에 포함된 각 학생 및 교사에 대해 Microsoft 365 테넌트 내에서 만든 사용자 계정이 이미 있는 경우 이 옵션을 선택합니다.
   • 새 사용자 - SDS(클래식)가 OneRoster에 포함된 각 학생 및 교사에 대한 사용자 계정을 만들려면 이 옵션을 선택합니다.
   • 웹 액세스 URL - 인터넷에 액세스할 수 있는 SIS/SMS의 기본 OneRoster API URL입니다.
   • 클라이언트 ID - SIS/SMS OneRoster API에 연결하는 데 사용됩니다.
   • 클라이언트 암호 - SIS/SMS OneRoster API에 연결하는 데 사용됩니다.
   • 동기화할 학교 선택 - 이 옵션을 사용하면 OneRoster에서 동기화할 학교를 선택할 수 있습니다.
   • 학교 속성 - 포함할 학교 특성을 선택합니다.
   • 섹션 속성 - 포함할 섹션 특성을 선택합니다.
   • 비활성 속성 필터링 - 이 확인란을 선택하면 활성 레코드만 동기화됩니다.
   • 팀 만들기 옵션 – 이 확인란을 선택하면 SDS(클래식)가 동기화된 각 클래스에 대해 Microsoft 365 그룹 및 클래스 팀을 만듭니다. 확인란을 선택 취소한 상태로 두면 SDS(클래식)는 Microsoft 365 그룹만 만듭니다.
   • 지원되지 않는 문자 바꾸기 - 이 확인란을 선택하면 지원되지 않는 문자가 지원되는 문자로 자동으로 대체됩니다.
   • 섹션 그룹 표시 이름에 대한 동기화 옵션 - 이 확인란을 선택하면 교사가 첫 번째 동기화 후 섹션 표시 이름을 제어하고 SDS가 교사가 변경한 섹션 DisplayName 변경 내용을 덮어쓰지 않도록 할 수 있습니다.
   • 학생 액세스 지연 - 이 옵션을 사용하면 학생이 수업을 볼 수 있도록 향후 날짜를 설정할 수 있습니다. 학생이 수업을 즉시 볼 수 있도록 하려면 이 옵션을 사용하지 않도록 설정합니다.
   • 언제 이 프로필 동기화를 중지해야 하나요? - 일반적으로 학년 말에 이 작업을 수행하려고 합니다. 이 프로필의 동기화를 중지하면 이 프로필과 연결된 클래스를 사용 중지할 수 있습니다.

   참고

   현재 혼합 형식을 사용하는 단일 테넌트(즉, V1 및 V2 동기화 프로필이 적극적으로 실행되고 둘 다 'Insights에 동기화'로 설정됨)가 작동하지 않습니다.

   참고

   Insights에 동기화가 SIMS 및 Infinite Campus 공급자에 대한 지원을 보류 중입니다.

4. 교사 옵션 페이지에서 적절한 ID 일치 옵션을 선택하고 교사 속성이 선택되어 있는지 확인한 다음, 다음을 선택합니다.

   

   • 기본 키(대상 디렉터리) - SDS ID 일치에 사용되는 Microsoft Entra ID 사용자 특성입니다. 적절한 대상 디렉터리 특성을 선택하고 교사에 대한 ID 일치 설정을 올바르게 구성하는 방법에 대한 자세한 내용은 ID 일치 비디오를 시청하세요.
   • 도메인(선택 사항) - 선택한 원본 디렉터리 특성에 추가하여 교사 ID 일치를 완료할 수 있는 선택적 도메인 값입니다. UserPrincipalName 또는 Mail 특성과 일치해야 하는 경우 문자열에 도메인이 포함되어 있어야 합니다. 원본 특성은 이미 도메인을 포함해야 하거나 이 드롭다운 메뉴를 사용하여 원본 특성에 적절한 도메인을 추가할 수 있습니다.
   • 기본 키(원본 디렉터리) - SDS ID 일치에 사용되는 OneRoster의 교사 특성입니다. 적절한 원본 디렉터리 특성을 선택하고 교사의 ID 일치 설정을 올바르게 구성하는 방법에 대한 자세한 내용은 ID 일치 비디오를 시청하세요.

5. 학생 옵션 페이지에서 적절한 ID 일치 옵션을 선택하고 학생 속성이 선택되어 있는지 확인한 다음, 다음을 선택합니다.

   

   • 기본 키(원본 디렉터리) - SDS ID 일치에 사용되는 OneRoster의 학생 특성입니다. 적절한 원본 디렉터리 특성을 선택하고 교사의 ID 일치 설정을 올바르게 구성하는 방법에 대한 자세한 내용은 ID 일치 비디오를 시청하세요.
   • 기본 키(대상 디렉터리) - SDS ID 일치에 사용되는 Microsoft Entra ID 사용자 특성입니다. 적절한 대상 디렉터리 특성을 선택하고 학생의 ID 일치 설정을 올바르게 구성하는 방법에 대한 자세한 내용은 ID 일치 비디오를 시청하세요.
   • 도메인(선택 사항) - 선택한 원본 디렉터리 특성에 추가하여 학생 ID 일치를 완료할 수 있는 선택적 도메인 값입니다. UserPrincipalName 또는 Mail 특성과 일치해야 하는 경우 문자열에 도메인이 포함되어 있어야 합니다. 원본 특성은 이미 도메인을 포함해야 하거나 드롭다운 메뉴를 사용하여 원본 특성에 적절한 도메인을 추가할 수 있습니다.

6. 검토 페이지에서 적절한 선택을 되었는지 확인합니다. 충족되는 경우 프로필 만들기를 선택합니다.

   

OneRoster API의 필터링된 상태

• 학생 및 등록 – SDS는 학교 연결 및 상태 따라 일부 학생을 동기화합니다.

  • 동기화됨
    • 활성
  • 동기화되지 않음
    • 삭제하려면

• 교사 – SDS는 학교 협회 및 상태 따라 일부 학생을 동기화합니다.

  • 동기화됨
    • 활성
  • 동기화되지 않음
    • 삭제하려면

• 수업 - SDS는 학교 연결 및 교직원 유형에 따라 일부 수업을 동기화합니다.

  • 동기화됨
    • 활성
  • 동기화되지 않음
    • 삭제하려면

• 학교 – SDS는 학교 연결 및 교직원 유형에 따라 일부 학교를 동기화합니다.

  • 동기화됨
    • 활성
  • 동기화되지 않음
    • 삭제하려면

  

비디오: OneRoster API 배포

비디오: 동기화를 위해 원본 및 대상 특성을 일치시킬 수 있는 방법

동기화에 대한 일치 논리 성공 및 실패의 다양한 예제를 보려면 ID 일치 비디오를 watch.