SDS V2 CSV 파일 형식

  • 아티클

수집 방법별 핵심 SDS 기능 및 Microsoft 365 기능

SDS V2 형식의 CSV(쉼표로 구분된 값) 파일을 사용하여 SIS(학교 정보 시스템)를 Office 365 동기화할 수 있습니다. SDS V2 CSV 파일 형식을 사용하여 아래 데이터 범주를 수집하면 프로비저닝을 위한 핵심 SDS 기능을 확인할 수 있습니다. 또한 아래에 나열된 Microsoft 365(Microsoft 365) 제품 및 기능에 대한 환경을 개선할 수 있습니다. SDS V2 CSV 파일 형식은 지원하는 데이터 범주를 계속 확장합니다.

참고

CSV V2 형식의 현재 고객은 2022년 5월까지 계속 사용할 수 있습니다. 추가 기능과 함께 CSV V2.1 형식 을 사용하는 것이 좋습니다.

csv-file-v2.png.

SDS V2 형식을 사용하는 경우 파일의 형식을 적절하게 지정해야 합니다. 이 문서에서는 SDS에 사용할 서식 요구 사항 및 지원되는 특성에 대해 설명합니다. 아래에 자세히 설명된 대로 명명된 네 개의 파일을 모두 업로드해야 합니다. 파일 및 열 머리글은 대/소문자를 구분합니다. SDS V2 CSV 파일의 샘플 집합을 검토하고 다운로드하려면 SDS GitHub 리포지토리를 참조하세요.

csv-file-v2-1.png.

각 CSV 파일에는 아래 녹색 으로 강조 표시된 모든 필수 필드가 포함되어야 합니다. 강조 표시되지 않는 필드는 선택 사항입니다. 특정 특성의 콘텐츠는 선택 사항일 수 있지만 열 머리글이 필요합니다. 또한 형식 열에 표시된 대로 정의된 열거형 값이 있는 특성에는 지원하는 특정 값 집합이 있습니다. 다음 섹션에서 각 열거형 특성에 대한 열거형 값의 지원 집합을 참조하세요.

csv-file-v2-2.png.

csv-file-v2-3.png.

csv-file-v2-4.png.

csv-file-v2-5.png.

열거형 값(열거형) 지원됨

새 SDS V2 형식에는 열거형 값으로 정의된 몇 가지 특성이 있습니다. 즉, CSV 파일 내에서 선택한 값 집합만 제공할 수 있습니다. 지정된 값 이외의 항목은 동기화 처리 중에 오류가 발생합니다. 아래 섹션에서는 SDS V2 형식에서 지원되는 열거형 값을 정의합니다.

users.csv 아래 열거형 값을 지원하는 "role" 특성이 포함되어 있습니다.

csv-file-v2-6.png.

users.csv "grade" 특성을 포함하고 아래 열거형 값을 지원합니다.

csv-file-v2-7.png.

orgs.csv "type" 특성을 포함하고 아래 열거형 값을 지원합니다.

csv-file-v2-8.png.

enrollments.csv "role" 특성을 포함하고 아래 열거형 값을 지원합니다.

csv-file-v2-9.png.