SDS V2.1 CSV 파일 형식
SDS V2.1 형식의 CSV(쉼표로 구분된 값) 파일을 사용하여 SIS(학교 정보 시스템)를 Office 365 동기화할 수 있습니다. SDS V2.1 CSV 파일 형식을 사용하여 데이터 범주를 수집하면 프로비전에 대한 핵심 SDS 기능을 점등할 수 있습니다. 또한 Microsoft 365 제품 및 기능에 대한 환경을 개선하는 데 도움이 됩니다. SDS V2.1 CSV 파일 형식은 지원하는 데이터 범주를 계속 확장합니다.
SDS V2.1 형식을 사용하는 경우 파일의 형식을 적절하게 지정해야 합니다. 세부 정보로 정확하게 명명된 파일을 업로드합니다. 열 머리글은 대/소문자를 구분합니다. CSV 파일은 UTF-8 형식 및 RFC 규격이어야 합니다. 또한 들어오는 데이터의 줄 바꿈도 허용하지 않습니다. SDS V2.1 CSV 파일의 샘플 집합을 검토하고 다운로드하려면 SDS GitHub 리포지토리를 참조하세요.
중요
인바운드 흐름을 만드는 동안 초기 업로드 후에는 선택적 파일의 데이터 변경 여부에 관계없이 항상 동일한 파일 집합을 후속 업로드에 제공해야 합니다. 그렇지 않은 경우 시스템에서 레코드가 더 이상 활성 상태가 아님을 확인하고 이를 표시합니다.
필수: 다음 세 개의 파일을 제공해야 합니다. 클래스가 아닌 사용자만 관리하는 경우 이러한 파일만 제공해야 합니다.
orgs.csv
users.csv
roles.csv
선택 사항/필수: 사용자만 관리하는 경우 다음 두 파일이 필요하지 않습니다. 또한 클래스 및 클래스 등록을 관리하는 경우 위의 세 파일과 함께 아래에 나열된 두 개의 파일을 제공해야 합니다.
classes.csv
enrollments.csv
선택 사항: 다음은 선택적 파일이며 환경을 개선하는 데 사용됩니다. 위의 파일에 아래 참고 사항에 따라 데이터 참조가 없는 한 이러한 파일은 필요하지 않습니다.
academicSessions.csv(roles.csv, classes.csv 또는 courses.csv 학술 세션 데이터가 포함된 경우 데이터를 처리할 때 오류 메시지를 방지하기 위해 해당 데이터를 제공해야 합니다.)
courses.csv(classes.csv 데이터에 과정에 대한 링크가 포함된 경우 데이터를 처리할 때 오류 메시지를 방지하기 위해 해당 데이터를 제공해야 합니다.)
demographics.csv
userFlags.csv
relationships.csv
각 CSV 파일에는 '필수' 아래에 '예'로 표시되는 필드에 대한 데이터가 포함되어야 합니다. '아니요'라고 적어진 필드는 '선택적' 데이터입니다. '필수'로 표시된 필드 헤더는 제공된 파일에 있어야 합니다. 그렇지 않으면 허용되지 않습니다. 해당 선택적 데이터를 전달하지 않으면 "선택 사항"으로 표시된 필드 헤더가 파일에 있을 필요가 없습니다.
'데이터 형식' 열에 표시된 대로 정의된 열거형 값이 있는 필드에는 지원하는 특정 값 집합이 있습니다. 열거형 필드에 지원되는 기본값 집합은 기본값 목록을 참조하세요.
orgs.csv
| 필드 | 필수 여부 | 예제 | 데이터 형식 |
|---|---|---|---|
| sourcedId | 예 | 10001 | 고유 ID |
| 이름 | 예 | 공학 대학 | String |
| 형식 | 예 | 대학 | 열거형 |
| parentSourcedId | 아니오 | 10000 | 고유 ID |
users.csv
| 필드 | 필수 여부 | 예제 | 데이터 형식 |
|---|---|---|---|
| sourcedId | 예 | 14001 | 고유 ID |
| 사용자 | 예 | cbeane@domain.com | String |
| familyName | 예(사용자를 만드는 경우에만) | 크레이그 | 문자열 |
| givenName | 예(사용자를 만드는 경우에만) | Beane | String |
| activeDirectoryMatchId | 아니오 | craig.beane@domain.com | String |
| 전자 메일 | 아니오 | cbeane@domain.com | 전자 메일 |
| 전화 | 아니오 | +1234567890 | Phone |
| Sms | 아니오 | +1234567890 | Phone |
| userNumber | 아니오 | 14001 | 문자열 |
- familyName 및 givenName은 '일치하지 않는 사용자 만들기' 옵션을 사용하는 경우 사용자에게 필요합니다.
- familyName, givenName 및 전자 메일은 relationships.csv 연락처 관계 역할이 있는 사용자에 대해 '학생 연락처 연결' 옵션을 사용하는 경우 사용자에게 필요합니다. 직원이지만 연락처인 사용자는 개인 전자 메일 주소와 연결된 연락처 사용자 레코드와 함께 두 개의 사용자 레코드를 나열하는 것이 좋습니다.
- 전화 및 sms 필드는 더하기 문자가 전화 번호로 사용되고 성공하는 E.164 표준에 따라 서식이 지정되거나 국가 코드, 지역 코드, 전화 접두사 및 줄 번호가 뒤따르는 더하기 문자가 필요합니다.
- 암호는 더 이상 새 사용자를 만들기 위한 기본 암호를 제공하는 데 사용되지 않습니다.
roles.csv
| 필드 | 필수 여부 | 예제 | 데이터 형식 |
|---|---|---|---|
| userSourcedId | 예 | 14001 | 고유 ID |
| orgSourcedId | 예 | 10001 | 고유 ID |
| 역할 | 예 | 학생 | 열거형 |
| sessionSourcedId | 아니오 | FS2021 | 고유 ID |
| 학년 | 아니오 | PS1 | 열거형 |
| isPrimary | 아니오 | true | 부울 |
| roleStartDate | 아니오 | 2020-08-24 | 날짜 |
| roleEndDate | 아니오 | 2020-12-11 | 날짜 |
- 'userSourcedId' 필드를 사용하여 연결된 사용자에 대한 참조가 필요합니다. 이렇게 하면 users.csv 파일에 대한 종속성이 생성됩니다.
- 'orgSourcedId' 필드를 사용하여 연결된 조직에 대한 참조가 필요합니다. 이렇게 하면 orgs.csv 파일에 대한 종속성이 생성됩니다.
- 통과된 경우: 'sessionSourcedId' 필드를 사용하여 연결된 용어(학술 세션)에 대한 참조가 필요합니다. 이렇게 하면 academicSessions.csv 파일에 대한 종속성이 생성됩니다.
- isPrimary는 이 역할이 해당 조직의 기본(true) 또는 보조(false) 역할인지 여부를 나타냅니다. 동일한 사용자 및 동일한 조직에 대해 여러 역할을 전달하는 경우 각 조직에 대해 기본 역할이 하나만 (true)로 설정되어야 합니다.
- ISO8601 형식으로 제공할 날짜 값입니다.
classes.csv
| 필드 | 필수 여부 | 예제 | 데이터 형식 |
|---|---|---|---|
| sourcedId | 예 | 12001 | 고유 ID |
| orgSourcedId | 예 | 10001 | 고유 ID |
| title | 예 | 컴퓨터 과학 101 | String |
| sessionSourcedIds | 아니오 | FS2021 | 고유 ID[] |
| courseSourcedId | 아니오 | C12001 | 고유 ID |
| 코드 | 아니오 | 12001 | 문자열 |
- 이렇게 하려면 'orgSourcedId' 필드를 사용하여 연결된 학교(조직)에 대한 참조가 필요합니다. 이렇게 하면 orgs.csv 파일에 대한 종속성이 생성됩니다.
- 통과된 경우: 'sessionSourcedIds' 필드를 사용하여 연결된 용어(학술 세션)에 대한 참조가 필요합니다. 이렇게 하면 academicSessions.csv 파일에 대한 종속성이 생성됩니다.
- 전달된 경우: 클래스가 같은 학년도의 여러 세션에 연결된 경우(예: 가을 학기 및 봄 학기) 레코드의 세션에 대해 sourcedId를 둘 다 제공할 수 있습니다. 값은 따옴표로 묶고 쉼표로 구분된 값을 가진 단일 문자열로 결합해야 합니다.
- 여러 sessionSourcedIds에 대한 연결은 Data Lake에만 저장됩니다.
- 세션 ID에 대한 Microsoft 365 그룹 확장 특성은 여러 연결을 지원하지 않습니다.
- 전달된 경우: 'courseSourcedId' 필드를 사용하여 연결된 과정에 대한 참조가 필요합니다. 이렇게 하면 courses.csv 파일에 대한 종속성이 생성됩니다.
enrollments.csv
| 필드 | 필수 여부 | 예제 | 데이터 형식 |
|---|---|---|---|
| classSourcedId | 예 | 12001 | 고유 ID |
| userSourcedId | 예 | 14001 | 고유 ID |
| 역할 | 예 | 학생 | 열거형 |
- 이렇게 하려면 'classSourcedId' 필드를 사용하여 연결된 클래스에 대한 참조가 필요합니다. 이렇게 하면 classes.csv 파일에 대한 종속성이 생성됩니다.
- 이렇게 하려면 'userSourcedId' 필드를 사용하여 연결된 사용자에 대한 참조가 필요합니다. 이렇게 하면 users.csv 파일에 대한 종속성이 생성됩니다.
academicSessions.csv
| 출원 | 필수 여부 | 예제 | 데이터 형식 |
|---|---|---|---|
| sourcedId | 예 | FS2021 | 고유 ID |
| title | 예 | 가을 학기 | String |
| 형식 | 예 | 학기 | 열거형 |
| schoolYear | 예 | 2021 | 열거형 |
| Startdate | 예 | 2020-08-24 | 날짜 |
| Enddate | 예 | 2020-12-11 | 날짜 |
- 날짜 값이 ISO8601 형식으로 제공될 것으로 예상합니다.
courses.csv
| 필드 | 필수 여부 | 예제 | 데이터 형식 |
|---|---|---|---|
| sourcedId | 예 | C12001 | 고유 ID |
| orgSourcedId | 예 | 10001 | 고유 ID |
| title | 예 | 컴퓨터 과학 101 | String |
| 코드 | 아니오 | CS101 | 문자열 |
| schoolYearSourcedId | 아니오 | Y2021 | 고유 ID |
| subject | 아니오 | 10 | 열거형 |
| 학년 | 아니오 | 학부 | 열거형 |
- 이렇게 하려면 orgSourcedId 필드를 사용하여 연결된 organization(조직)에 대한 참조가 필요합니다. 이렇게 하면 orgs.csv 파일에 대한 종속성이 생성됩니다.
- 전달된 경우: 형식 = schoolYear인 'schoolYearSourcedId' 필드를 사용하여 연결된 학업 세션 연도 레코드에 대한 참조가 필요합니다. 이렇게 하면 academicSessions.csv 파일에 대한 종속성이 생성됩니다.
relationships.csv
| 필드 | 필수 여부 | 예제 | 데이터 형식 |
|---|---|---|---|
| userSourcedId | 예 | 14001 | 고유 ID |
| relationshipUserSourcedId | 예 | P14001 | 고유 ID |
| relationshipRole | 예 | 가디언 | 열거형 |
- 또한 연락처 관계(보호자)를 동기화하는 경우 users.csv 해당 연락처에 대한 레코드를 포함해야 합니다.
- 이렇게 하려면 'userSourcedId' 필드를 사용하여 연결된 사용자에 대한 참조가 필요합니다. 이렇게 하면 users.csv 파일에 대한 종속성이 생성됩니다.
- 이렇게 하려면 'relationshipUserSourcedId' 필드를 사용하여 연결된 사용자에 대한 참조가 필요합니다. 이렇게 하면 users.csv 파일에 대한 종속성이 생성됩니다.
- 또한 연락처 관계 역할이 있는 사용자에게는 familyName, givenName 및 전자 메일이 필요합니다.
demographics.csv
| 필드 | 필수 여부 | 예제 | 데이터 형식 |
|---|---|---|---|
| userSourcedId | 예 | 14001 | 고유 ID |
| 섹스 | 아니오 | 남성 | 열거형 |
| 생년월일 | 아니오 | 2001-07-20 | 날짜 |
| birthCity | 아니오 | 우드빌(Woodville) | String |
| birthState | 아니오 | WA | 열거형 |
| birthCountry | 아니오 | 미국 | String |
| ethnicityCodes | 아니오 | hispanicOrLatinoEthnicity | 열거형[] |
| raceCodes | 아니오 | demographicRaceTwoOrMoreRaces | 열거형[] |
- 이렇게 하려면 'userSourcedId' 필드를 사용하여 연결된 사용자에 대한 참조가 필요합니다. 이렇게 하면 users.csv 파일에 대한 종속성이 생성됩니다.
- 'raceCodes'에 매핑되는 여러 값은 따옴표로 묶고 쉼표로 구분된 값이 있는 단일 문자열로 결합되어야 합니다.
userFlags.csv
| 필드 | 필수 여부 | 예제 | 데이터 형식 |
|---|---|---|---|
| userSourcedId | 예 | 14001 | 고유 ID |
| 플래그 | 예 | Lep | 열거형 |
- 이렇게 하려면 'userSourcedId' 필드를 사용하여 연결된 사용자에 대한 참조가 필요합니다. 이렇게 하면 users.csv 파일에 대한 종속성이 생성됩니다.