SDS v1 CSV 형식을 사용하여 데이터 수집

아티클
11/30/2023

주의

SDS(클래식) 전환 고객: v1 형식에 따라 데이터를 새 SDS 환경으로 가져오는 데 모든 필드가 지원되는 것은 아닙니다. SDS v1 CSV 파일 형식의 필수 열 아래에 데이터가 지원되지 않음으로 표시됩니다.

중요

또한 전달된 학년 값과 과정 주체 값은 해당 ENUM(값 목록) 코드에 맞춰야 합니다. 필요한 경우 값 목록 관리를 활용하여 성적 값을 확장하고 과정 주체 를 사용하여 기본적으로 지원되지 않는 코드 값을 지원합니다.

Microsoft 365 Education 테넌트용 SDS 설정

Microsoft 365 Education 테넌트
전역 관리자 권한 필요

경고

CSV(쉼표로 구분된 값) 파일을 사용하여 SIS(학교 정보 시스템)/ SMS(학생 관리 시스템)를 동기화할 수 있습니다. SDS는 UTF-8 형식 및 RFC 규격의 CSV 파일 업로드만 지원합니다. 각 CSV 파일에는 '필수' 아래에 '예'로 표시되는 필드에 대한 데이터가 포함되어야 합니다. '아니요'라고 적어진 필드는 '선택적' 데이터입니다. '필수'로 표시된 필드 헤더는 제공된 파일에 있어야 합니다. 그렇지 않으면 허용되지 않습니다. "선택 사항"으로 표시된 필드 헤더는 해당 선택적 데이터를 전달하지 않는 경우 파일에 있을 필요가 없습니다. 자세한 내용은 SDS v1 CSV 파일 형식을 참조하세요.

중요

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

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

시작을 선택합니다.
계속을 선택합니다.

다음 단계 전에 서비스가 테넌트에게 프로비전되도록 잠시 기다립니다.
새 인바운드 흐름 만들기 및 다음을 선택하여 계속합니다.
데이터 원본을 선택합니다. CSV의 경우 내 데이터에 연결 옵션을 선택합니다.
형식을 선택합니다. CSV의 경우 CSV 옵션을 선택합니다. 계속하려면 다음 으로 진행합니다.
SIS/SMS의 이름을 제공해야 합니다. 또한 SDS v1 CSV를 선택합니다. 다음을 선택하여 계속합니다.
파일 찾아보기를 선택하여 찾아보기 및 선택 대화 상자를 표시합니다.

중요

인바운드 흐름을 만드는 동안 초기 업로드 후에는 선택적 파일의 데이터 변경 여부에 관계없이 항상 동일한 파일 집합을 후속 업로드에 제공해야 합니다. 그렇지 않은 경우 시스템에서 레코드가 더 이상 활성 상태가 아님을 확인하고 이를 표시합니다.
파일 위치로 이동하여 파일을 선택합니다.

SDS v1 CSV 파일 형식을 참조하세요.

필수: 진행하려면 먼저 아래에 나열된 세 개의 파일을 선택해야 합니다. 클래스가 아닌 사용자만 관리하는 경우 이러한 파일만 제공해야 합니다.
- school.csv
- student.csv
- teacher.csv
선택 사항/필수: 사용자만 관리하는 경우에는 필요하지 않습니다. 또한 클래스 및 클래스 등록을 관리하는 경우 위의 세 파일과 함께 아래에 나열된 세 개의 파일을 제공해야 합니다. 그렇지 않은 경우 이러한 이름의 파일을 선택하지 마세요. 한 파일이 선택되어 있고 다른 파일이 선택되지 않은 경우 다음을 선택하면 이러한 파일 중 하나가 누락되었다는 메시지가 나타납니다. 계속하기 전에 수정해야 합니다.
- section.csv
- studentenrollment.csv
- teacherroster.csv
선택 사항: 진행하는 데 필요하지는 않지만 환경을 향상시킬 수 있습니다. 아래 파일 중 하나를 선택한 경우 다른 파일도 선택하여 진행해야 합니다.
- user.csv
- guardianrelationship.csv(연락처 연결을 빌드하려면 사용자 및 학생 레코드가 필요합니다.)
파일 선택을 완료했으면 다음 을 선택하여 계속합니다. 시스템은 다음 화면으로 계속 진행하기 전에 선택한 파일의 이름의 유효성을 검사합니다. 필요한 파일을 찾을 수 없는 경우 메시지가 나타나고 파일 또는 파일의 주소를 지정하고 다시 선택해야 합니다.
파일 이름의 유효성을 검사한 후에는 파일이 업로드되어 선택한 파일의 구조의 유효성을 검사하고 SDS CSV v1 사양에 따라 헤더 이름으로 올바르게 형식이 지정됩니다.
- 메시지가 표시되는 경우 : 아래에 있는 파일 중 하나 이상이 예상된 형식과 일치하지 않는 경우 화면을 검토하여 파일의 형식이 올바르게 지정되지 않았는지 확인합니다. 문제를 수정한 후 파일을 다시 선택하려면 이전 화면으로 다시 이동해야 합니다.
- 메시지가 표시되는 경우: 선택적 파일을 하나 이상 찾을 수 없습니다. 화면을 검토하여 찾을 수 없는 파일 또는 파일을 확인합니다. 이 메시지가 필요하지 않은 경우 파일을 다시 선택하려면 이전 화면으로 다시 이동해야 합니다. 그렇지 않으면 다음 을 선택하여 계속합니다.
파일 스키마의 유효성을 검사한 후 SDS는 업로드된 파일에서 빠른 데이터 유효성 검사를 수행합니다. 업로드된 데이터는 SDS 데이터 일치 및 유효성 검사 규칙 중 일부를 통과하여 필요한 데이터와 제공된 선택적 데이터를 식별하는 데 도움이 됩니다. 모든 유효성 검사 규칙이 아니라 가장 자주 발생한 규칙입니다.

팁

데이터 유효성 검사 결과는 온보딩 또는 csv 업로드 환경에서 차단되지 않습니다. 두 가지 옵션이 있습니다. 즉, 데이터를 수정한 후 종료하고 나중에 반환하거나 다음 단계로 진행하여 데이터 연결을 계속 설정하고 나중에 수정된 데이터에 후속 업로드를 제공합니다.
조사를 위해 플래그가 지정된 데이터에 대한 자세한 내용은 목록에서 파일 이름에 대한 세부 정보 보기를 선택하여 특정 항목을 드릴합니다.

또한 파일별로 보고서를 다운로드하여 원본 시스템의 조사 및 수정 사항을 시작할 수 있습니다.

플래그가 지정된 파일 열은 플래그가 지정된 규칙 또는 규칙을 확장하고 조사할 수 있는 기능으로 표시됩니다.

규칙을 클릭하면 예를 들어 상위 10개 레코드에 대한 또 다른 요약을 볼 수 있습니다.

조사가 완료되면 대화 상자를 닫은 다음을 선택합니다.
현재 학년을 선택하고 2023 또는 2022 – 2023과 같은 친숙한 이름을 제공합니다. (문자는 utf8이어야 하며 자동으로 제거됩니다.)

중요

학년도는 들어오는 데이터를 연결하여 연도에 따른 기록 데이터를 빌드하는 데 사용됩니다. 이 접근 방식은 학년도와 연도에 맞게 조정됩니다. 예를 들어 학년도에 걸쳐 2022년 8월 15일에 시작하여 2023년 6월 15일에 종료되는 경우 선택할 학년도 값은 2023년 말입니다. 자세한 내용은 학년 처리를 참조하세요.

학년이 시작되고 끝나는 날짜를 입력합니다.

SDS가 정의된 학년도에 따라 데이터 동기화를 중지해야 하는 날짜를 입력합니다. 방금 입력한 학년말 날짜에 데이터 동기화를 중지하는 것이 가장 일반적입니다.

다음을 선택하여 계속합니다.
사용자 ID 규칙 옵션을 선택합니다. 교직원 및 학생 역할 모두에 대해 선택합니다.

참고

사용자 일치는 인바운드 흐름으로 수행되며 Microsoft Entra ID 사용자 개체를 작성하거나 업데이트하지 않습니다. 일치가 수행되고 Education 데이터 레이크에 저장됩니다. 자세한 내용은 아웃바운드 흐름과 일치 링크의 작성에 대한 Microsoft 365 사용자 관리를 참조하세요.
- 원본의 특성: SIS/SMS에서 제공되는 데이터를 기반으로 하는 사용자 특성입니다.
  - 사용 가능한 소스 옵션은 Username, Email 및 ActiveDirectory MatchId입니다.
- 일치시킬 특성: 일치시킬 Microsoft Entra ID 사용자 속성입니다.
  - 사용 가능한 Microsoft Entra ID 일치 옵션은 UserPrincipalName 및 Mail입니다.
- (선택 사항) 사용자 데이터에 @domain 값이 포함되지 않은 경우 목록에서 도메인을 선택합니다.
경고

도메인을 선택하는 것은 선택 사항이며 원본에서 선택한 특성 에 따라 들어오는 데이터에 @domain 값이 포함되지 않은 경우에만 사용해야 합니다. 레코드에 값이 누락된 경우 SDS는 검사 않고 추가하지 않습니다. SDS는 @domain@domain 발생할 수 있는 모든 레코드에 도메인 선택을 추가하고 Microsoft Entra ID 사용자와 기존 사용자 매핑에 대한 일치 항목을 해당 인스턴스에서 찾을 수 없습니다.

주의

SIS/SMS 사용자(예: 직원 역할 그룹의 사용자)가 @domain1 또는 @domain2 또는 @domain3 연결할 수 있는 경우 원본 선택에서 선택한 특성(예: prefix@domain )에 따라 원본 데이터에 포함된 @domain 있어야 합니다. 일치하는 특성을 찾으려면 UserPrincipalName 또는 Mail에서 일치시킬 올바른 Microsoft Entra 사용자를 찾는 데 필요합니다.

사용자에게 여러 역할이 있는 instance 다음 규칙을 사용하여 사용자 레코드와 Microsoft Entra 사용자 개체 간에 사용해야 하는 교직원 또는 학생 일치 규칙을 결정합니다.
- 모든 학생 역할에 대해 isPrimary가 설정된 경우 교직원 역할에 대한 연결이 있더라도 학생 역할에 따라 일치가 수행됩니다.
- 모든 교직원 역할에 대해 isPrimary가 설정된 경우 학생 역할에 대한 연결이 있더라도 교직원 역할에 따라 일치가 이루어집니다.
- 교직원 및 학생 역할 모두에 대해 isPrimary가 설정된 경우 교직원 역할에 따라 일치가 이루어집니다.
- isPrimary가 어떤 역할, 특히 교직원 및 학생 역할 모두에 대한 혼합으로 설정되지 않은 경우 경기는 교직원 역할을 기반으로 합니다.
중요

Microsoft 365 사용자 관리 흐름을 구성할 때 이러한 규칙은 옵션이 일치하지 않는 사용자 만들기로 활성화되어 Microsoft Entra UserPrincipalName 속성의 구문을 정의하는 경우에 사용됩니다.

선택한 항목에 만족하면 다음 을 선택하여 계속합니다.
검토 및 만들기에 제시된 정보를 검토합니다. 모든 항목이 올바르게 표시되면 만들기 단추를 선택합니다. 그렇지 않은 경우 다시 탐색하여 수정할 수 있습니다.
인바운드 데이터 흐름이 생성되고 첫 번째 실행이 보류 중입니다. 완료 단추를 선택합니다. 다시 확인하여 첫 번째 실행의 상태 확인합니다.

팁

Connect 데이터 구성을 정의한 직후, 활성 첫 번째 실행 중 또는 첫 번째 실행이 완료된 후 나중에 데이터 관리 구성 을 설정할 수 있습니다.
실행 상태 검사 홈 dashboard 페이지로 다시 이동합니다.

데이터에 문제가 없는 경우 홈 dashboard "데이터 오류 또는 경고를 찾을 수 없음"과 "마지막 실행 중에 데이터 오류 또는 경고가 발생하지 않았습니다. 훌륭한 일을 계속하세요!"

데이터에 문제가 있는 경우 홈 dashboard '데이터에 몇 가지 문제가 발견되었습니다'라고 알리고 동기화 상태를 조사하도록 권장합니다.

참고

원본 데이터의 변경 내용을 업데이트하기 위해 첫 번째 실행 후 변경 내용을 수동으로 업로드하려면 SDS CSV를 사용하여 원본 데이터 업데이트를 참조하세요.

해당 실행이 있는 최대 업로드는 달력 일당 6회입니다. 업로드하는 경우 하루에 6번이 지나면 12시간마다 SDS 자동화된 실행 주기를 기반으로 최대 2회까지만 실행됩니다.