SDS V1 CSV 파일 형식
중요
SDS(클래식) 전환 고객: v1 형식에 따라 데이터를 새 SDS 환경으로 가져오는 데 모든 필드가 지원되는 것은 아닙니다. SDS v1 CSV 파일 형식의 필수 열 아래에 데이터가 지원되지 않음으로 표시됩니다.
중요
또한 전달된 학년 값과 과정 주체 값은 해당 ENUM(값 목록) 코드에 맞춰야 합니다. 필요한 경우 값 목록 관리를 활용하여 성적 값을 확장하고 과정 주체 를 사용하여 기본적으로 지원되지 않는 코드 값을 지원합니다.
SDS V1 형식의 CSV(쉼표로 구분된 값) 파일을 사용하여 SIS(학교 정보 시스템)를 Office 365 동기화할 수 있습니다. SDS V1 CSV 파일 형식을 사용하여 아래 데이터 범주를 수집하면 프로비저닝을 위한 핵심 SDS 기능을 확인할 수 있습니다. 또한 Microsoft 365 제품 및 기능에 대한 환경을 개선하는 데 도움이 됩니다.
SDS V1 형식을 사용하는 경우 파일의 형식을 적절하게 지정해야 합니다. 아래에 자세히 설명된 대로 정확하게 명명된 파일을 업로드합니다. 열 머리글은 대/소문자를 구분합니다. CSV 파일은 UTF-8 형식 및 RFC 규격이어야 합니다. 또한 들어오는 데이터의 줄 바꿈도 허용하지 않습니다. SDS V1 CSV 파일의 샘플 집합을 검토하고 다운로드하려면 SDS GitHub 리포지토리를 참조하세요.
중요
인바운드 흐름을 만드는 동안 초기 업로드 후에는 선택적 파일의 데이터 변경 여부에 관계없이 항상 동일한 파일 집합을 후속 업로드에 제공해야 합니다. 그렇지 않은 경우 시스템에서 레코드가 더 이상 활성 상태가 아님을 확인하고 이를 표시합니다.
필수: 진행하려면 먼저 아래에 나열된 세 개의 파일을 선택해야 합니다. 클래스가 아닌 사용자만 관리하는 경우 이러한 파일만 제공해야 합니다.
school.csv
student.csv
teacher.csv
선택 사항/필수: 사용자만 관리하는 경우에는 필요하지 않습니다. 또한 클래스 및 클래스 등록을 관리하는 경우 위의 세 파일과 함께 아래에 나열된 세 개의 파일을 제공해야 합니다. 그렇지 않은 경우 이러한 이름의 파일을 선택하지 마세요.
section.csv
studentenrollment.csv
teacherroster.csv
선택 사항: 진행하는 데 필요하지는 않지만 환경을 향상시킬 수 있습니다. 아래 파일 중 하나를 선택한 경우 다른 파일도 선택하여 진행해야 합니다.
user.csv
guardianrelationship.csv(연락처 연결을 빌드하려면 사용자 및 학생 레코드가 필요합니다.)
각 CSV 파일에는 '필수' 아래에 '예'로 표시되는 필드에 대한 데이터가 포함되어야 합니다. '아니요'라고 적어진 필드는 '선택적' 데이터입니다. '필수'로 표시된 필드 헤더는 제공된 파일에 있어야 합니다. 그렇지 않으면 허용되지 않습니다. 해당 선택적 데이터를 전달하지 않으면 "선택 사항"으로 표시된 필드 헤더가 파일에 있을 필요가 없습니다.
'데이터 형식' 열에 표시된 대로 정의된 열거형 값이 있는 필드에는 지원하는 특정 값 집합이 있습니다. 열거형 필드에 지원되는 기본값 집합은 기본값 목록을 참조하세요.
school.csv
| 필드 | 필수 여부 | 예제 | 데이터 형식 |
|---|---|---|---|
| SIS ID | 예 | 456789 | 고유 ID |
| 이름 | 예 | Contoso 고등학교 | String |
| 학교 NCES_ID | 아니오 | 456789 | String |
| 학교 번호 | 지원되지 않는 데이터 | ||
| 저학년 | 지원되지 않는 데이터 | ||
| 고학년 | 지원되지 않는 데이터 | ||
| 상태 ID | 지원되지 않는 데이터 | ||
| 보안 주체 SIS ID | 지원되지 않는 데이터 | ||
| 사용자 이름 | 지원되지 않는 데이터 | ||
| 보안 주체 보조 전자 메일 | 지원되지 않는 데이터 | ||
| 주소 | 지원되지 않는 데이터 | ||
| 구/군/시 | 지원되지 않는 데이터 | ||
| 상태 | 지원되지 않는 데이터 | ||
| 우편 번호 | 지원되지 않는 데이터 | ||
| 국가 | 지원되지 않는 데이터 | ||
| Phone | 지원되지 않는 데이터 | ||
| 영역 | 지원되지 않는 데이터 |
- 나열된 모든 조직은 organization 유형 'school'으로 설정됩니다.
student.csv
| 필드 | 필수 여부 | 예제 | 데이터 형식 |
|---|---|---|---|
| SIS ID | 예 | 123456 | 고유 ID |
| 학교 SIS ID | 예 | 456789 | 고유 ID |
| 사용자 이름 | 예 | jsmith@contoso.edu | String |
| 이름 | 예(사용자를 만드는 경우에만) | John | String |
| 성 | 예(사용자를 만드는 경우에만) | Smith | String |
| 중간 이름 | 아니오 | 윌리엄 | String |
| 보조 전자 메일 | 아니오 | jsmith@contoso.edu | 전자 메일 |
| 학생 번호 | 아니오 | 123456 | String |
| 학년 | 아니오 | 8 | 열거형 |
| 생년월일 | 아니요 | 2009-12-19 | 날짜 |
| 상태 | 지원되지 않는 데이터 | ||
| 암호 | 지원되지 않는 데이터 | ||
| 졸업 연도 | 지원되지 않는 데이터 | ||
| 상태 ID | 지원되지 않는 데이터 |
- 'School SIS ID' 필드를 사용하여 관련 학교에 대한 참조가 필요합니다. 이렇게 하면 school.csv 파일에 대한 종속성이 생성됩니다.
- 나열된 모든 사용자는 역할 유형 'student'으로 설정됩니다.
- 날짜 값이 ISO8601 형식으로 제공될 것으로 예상합니다.
- 학년 수준 ENUM의 들어오는 값(예: '1')에 누락된 선행 0은 정의된 값 목록(ENUM) '01'과 일치하며 '01'로 저장됩니다.
teacher.csv
| 필드 | 필수 여부 | 예제 | 데이터 형식 |
|---|---|---|---|
| SIS ID | 예 | 654321 | 고유 ID |
| 학교 SIS ID | 예 | 456789 | 고유 ID |
| 사용자 이름 | 예 | jcook@contoso.edu | String |
| 이름 | 예(사용자를 만드는 경우에만) | 제인 | String |
| 성 | 예(사용자를 만드는 경우에만) | 요리사 | String |
| 중간 이름 | 아니오 | 메 레디 스 | String |
| 교사 번호 | 아니요 | 654321 | String |
| 학년 | 아니오 | 8 | 열거형 |
| 보조 전자 메일 | 아니요 | jcook@contoso.edu | 전자 메일 |
| 상태 | 지원되지 않는 데이터 | ||
| 암호 | 지원되지 않는 데이터 | ||
| 제목 | 지원되지 않는 데이터 | ||
| 상태 ID | 지원되지 않는 데이터 | ||
| 자격 | 지원되지 않는 데이터 |
- 'School SIS ID' 필드를 사용하여 관련 학교에 대한 참조가 필요합니다. 이렇게 하면 school.csv 파일에 대한 종속성이 생성됩니다.
- 나열된 모든 사용자는 역할 유형 '교사'로 설정됩니다.
- 학년 수준 ENUM의 들어오는 값(예: '1')에 누락된 선행 0은 정의된 값 목록(ENUM) '01'과 일치하며 '01'로 저장됩니다.
section.csv
| 필드 | 필수 여부 | 예제 | 데이터 형식 |
|---|---|---|---|
| SIS ID | 예 | 334455 | 고유 ID |
| 학교 SIS ID | 예 | 456789 | 고유 ID |
| 섹션 이름 | 예 | 기간 1 - 세계 역사 | String |
| 섹션 번호 | 아니오 | 334466 | String |
| 과정 SIS ID | 아니오 | 123456789 | 고유 ID |
| 과정 이름 | 아니오 | 세계사 10 | String |
| 과정 번호 | 아니오 | 123456789 | String |
| 과정 설명 | 아니요 | 세계의 역사 | String |
| 과정 제목 | 아니요 | 54999 | 열거형 |
| 기간 SIS ID | 지원되지 않는 데이터 | ||
| 기간 이름 | 지원되지 않는 데이터 | ||
| 기간 시작 날짜 | 지원되지 않는 데이터 | ||
| 기간 종료 날짜 | 지원되지 않는 데이터 | ||
| 상태 | 지원되지 않는 데이터 | ||
| 기간 | 지원되지 않는 데이터 |
- 'School SIS ID' 필드를 사용하여 관련 학교에 대한 참조가 필요합니다. 이렇게 하면 school.csv 파일에 대한 종속성이 생성됩니다.
- 용어 정보가 필요한 경우 SDS v2.1 CSV 형식 으로 이동하고 academicSessions.csv 파일을 제공하는 것이 좋습니다.
studentenrollment.csv
| 필드 | 필수 여부 | 예제 | 데이터 형식 |
|---|---|---|---|
| 섹션 SIS ID | 예 | 334455 | 고유 ID |
| SIS ID | 예 | 123456 | 고유 ID |
- 이렇게 하려면 '섹션 SIS ID' 필드를 사용하여 연결된 섹션에 대한 참조가 필요합니다. 이렇게 하면 section.csv 파일에 대한 종속성이 생성됩니다.
- 이렇게 하려면 'SIS ID' 필드를 사용하여 연결된 사용자에 대한 참조가 필요합니다. 이렇게 하면 student.csv 파일에 대한 종속성이 생성됩니다.
teacherroster.csv
| 필드 | 필수 여부 | 예제 | 데이터 형식 |
|---|---|---|---|
| 섹션 SIS ID | 예 | 334455 | 고유 ID |
| SIS ID | 예 | 654321 | 고유 ID |
- 이렇게 하려면 '섹션 SIS ID' 필드를 사용하여 연결된 섹션에 대한 참조가 필요합니다. 이렇게 하면 section.csv 파일에 대한 종속성이 생성됩니다.
- 이렇게 하려면 'SIS ID' 필드를 사용하여 연결된 사용자에 대한 참조가 필요합니다. 이렇게 하면 teacher.csv 파일에 대한 종속성이 생성됩니다.
user.csv
| 필드 | 필수 여부 | 예제 | 데이터 형식 |
|---|---|---|---|
| 전자 메일 | 예 | jsmith@outlook.com | 전자 메일 |
| 이름 | 예 | John | String |
| 성 | 예 | Smith | String |
| Phone | 아니오 | +1234567890 | Phone |
| SIS ID | 아니오 | P_123456 | 고유 ID |
- 또한 연락처 관계(보호자)를 동기화하는 경우 user.csv 해당 연락처에 대한 레코드를 포함해야 합니다.
- 전화 필드는 더하기 문자가 사용되고 전화 번호로 성공하는 E.164 표준에 따라 서식이 지정되거나 국가 코드, 지역 코드, 전화 접두사 및 줄 번호가 뒤따르는 더하기 문자가 필요합니다.
guardianrelationship.csv
| 필드 | 필수 여부 | 예제 | 데이터 형식 |
|---|---|---|---|
| SIS ID | 예 | 123456 | 고유 ID |
| 전자 메일 | 예 | jsmith@outlook.com | 전자 메일 |
| 역할 | 아니오 | 상위 항목 | 열거형 |
- 또한 연락처 관계(보호자)를 동기화하는 경우 user.csv 해당 연락처에 대한 레코드를 포함해야 합니다.
- 이렇게 하려면 'Email' 필드를 사용하여 연결된 사용자에 대한 참조가 필요합니다. 이렇게 하면 user.csv 파일에 대한 종속성이 생성됩니다.
- 이렇게 하려면 'SIS ID' 필드를 사용하여 연결된 사용자에 대한 참조가 필요합니다. 이렇게 하면 student.csv 파일에 대한 종속성이 생성됩니다.
- 역할 값이 제공되지 않으면 관계 값은 기본적으로 'userContact'로 설정됩니다.