SDS(클래식) V2.1 CSV 파일 형식

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

SDS V2.1 형식의 CSV(쉼표로 구분된 값) 파일을 사용하여 SIS(학교 정보 시스템)를 Office 365 동기화할 수 있습니다. SDS V2.1 CSV 파일 형식을 사용하여 데이터 범주를 수집하면 프로비전에 대한 핵심 SDS 기능을 점등할 수 있습니다. 또한 나열된 Microsoft 365 제품 및 기능에 대한 환경을 개선하는 데 도움이 됩니다.

참고

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

SDS V2.1 파일의 형식을 적절하게 지정해야 합니다. 정확하게 자세히 명명된 5개의 파일을 모두 업로드합니다. 파일 및 열 머리글은 대/소문자를 구분합니다. CSV 파일은 UTF-8 형식이어야 합니다. SDS V2.1 CSV 파일의 샘플 집합을 검토하고 다운로드하려면 SDS GitHub 리포지토리를 참조하세요.

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

*'school'만 필터링하려면

사용자를 만드는 경우:

사용자 이름 필드는 SDS에서 허용하려면 도메인이 필요합니다. 예를 들면 cbean@domain.com와 같습니다.

relationships.csv 보호자 역할이 있는 사용자는 FamilyName, givenName 및 전자 메일이 필요합니다. 직원이지만 연락처인 사용자는 개인 전자 메일 주소와 연결된 연락처 사용자 레코드와 함께 두 명의 사용자 레코드가 나열되는 것이 좋습니다.

전화 및 SMS가 E.164에 있을 것으로 예상합니다. SDS 프로비저닝은 E.164에 맞지 않는 경우 전화 또는 SMS에 오류가 발생하지 않습니다. 유효성 검사는 () -, 공백, 마침표(.)를 제거하고 제공된 값의 맨 앞에 있는 경우 + 를 유지합니다.

*레코드에 여러 값이 있는 경우 SDS 프로비저닝과 하나의 값만 동기화합니다.

지원되는 열거형 값

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

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

사용자 조직 역할
학생	TeacherAssistant	Principal
프록터	교직원	SpecialServices
교사	교수	코치
ItAdmin	리서치 도구	도우미
OfficeStaff	강사	자
간호사	제휴	외래
직업치료사	동문	대체
강사	Advisor	Paraprofessional
PhysicalTherapist	교수	관리자
SpeechTherapist	VisionTherapist	기타

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

조직 유형
학교	MinistryOfEducation	LocalAuthority
부서	대학	지역
지구	대학	부문
로컬	캠퍼스	지방
상태	AdultEducation	ResearchCenter
국가	자치 제	프로그램
DepartmentOfEducation	AcademicTrust

demographics.csv "출생 상태" 특성을 포함하고 열거형 값을 지원합니다.

상태
Ak	라	또는
알	Ma	펜 실바 니 아
아칸소	메릴랜드	홍보
AS	나	비밀 번호
Az	Mh	Ri
CA	MI	사우스 캐롤라이나
공동	미네소타	Sd
코네티컷	모	테네시
Dc	Mp	Tx
DE	MS	유타
플로리다	마운트	버지니아
Fm	노스캐롤라이나	Vi
조지아	Nd	Vt
GU (구)	NE	WA
안녕	Nh	위스콘신
아이오 와	뉴저지	Wv
ID	Nm	와이오밍
Il	네바다	Aa
IN	뉴욕	Ae
Ks	오	Ap
켄터키	확인

academicSessions.csv 교육 세션 "type" 특성을 포함하고 열거형 값을 지원합니다.

교육 세션 유형
SchoolYear	학기	용어

demographics.csv "sex" 특성을 포함하고 열거형 값을 지원합니다.

섹스
남성	여성	NotSelected

academicSessions.csv "school year" 특성을 포함하고 열거형 값을 지원합니다.

학년도
2021	2025	2029
2022	2026	2030
2023	2027	2031
2024	2028

relationships.csv "관계 역할" 특성을 포함하고 열거형 값을 지원합니다.

관계 역할
상위 항목	가디언	보좌관
상대	자식	관리자
의사	기타

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

등록 역할
학생	VisionTherapist	대체
보좌관	Paraprofessional	Principal
프록터	TeacherAssistant	SpecialServices
교사	교수	Advisor
관리자	강사	코치
직업치료사	제휴	도우미
PhysicalTherapist	외래	교직원
SpeechTherapist	강사

Courses.csv 교육 세션 "주체" 특성을 포함하고 열거형 값을 지원합니다.

과정 제목	설명
01	영어 및 문학
02	수학
03	생명 및 물리 과학
04	사회 과학 및 역사
05	시각 및 공연 예술
07	종교 교육 및 신학
08	물리적, 건강 및 안전 교육
09	군사 과학
10	정보 기술
11	통신 및 오디오/시각 기술
12	비즈니스 및 마케팅
13	제조
14	의료 과학
15	공용, 보호 및 정부 서비스
16	호스피탈리티 및 관광
17	아키텍처 및 구성
18	농업, 식품 및 천연 자원
19	휴먼 서비스
20	운송, 유통 및 물류
21	엔지니어링 및 기술
22	기타
23	비주체별
24	세계 언어

userFlags.csv "플래그" 특성을 포함하고 열거형 값을 지원합니다.

사용자 플래그	설명
FreeLunch	무료 점심 식사
ReducedLunch	점심 식사 감소
노숙자	노숙자
GiftedOrTalented	재능이 있거나 재능 있는
504	섹션 504 배치
엘	영어 학습자
Lep	제한된 영어 숙련도
Iep	특수 교육 서비스/독립 교육 계획 적격

demographics.csv "민족성" 특성을 포함하고 열거형 값을 지원합니다.

민족성	설명
HispanicOrLatinoEthnicity	히스패닉 또는 라틴계 인종

demographics.csv "race" 특성을 포함하고 열거형 값을 지원합니다.

레이스	설명
AmericanIndianOrAlaskaNative	아메리칸 인디언 또는 알래스카 네이티브
NativeHawaiianOrOtherPacificIslander	하와이 원주민 또는 기타 태평양 섬 주민
BlackOrAfricanAmerican	흑인 또는 아프리카계 미국인
DemographicRaceTwoOrMoreRaces	여러 종족을 지정합니다.
아시아	아시아
하얀	하얀

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

Courses.csv 교육 세션 "등급" 특성을 포함하고 열거형 값을 지원합니다.

학년	설명
IT	유아/유아
홍보	유치원
Pk	Prekindergarten
TK	과도 유치원
Kg	유치원
01	1학년
02	2학년
03	3학년
04	4학년
05	초등학교 5학년
06	초등학교 6학년
07	7학년
08	8학년
09	9학년
10	10학년
11	11학년
12	12학년
13	13학년
14	14학년
Ps	중등도 게시물
Ug	등급이 지정되지 않음
기타	기타
PS1	중등 신입생
PS2	중등도 소포모어
Ps3	중등부 후배
Ps4	중등부 선임
학부	학부
졸업	졸업
대학원	연구에 중점을 두고 졸업
동문	동문
AdultEducation	성인 교육