다음을 통해 공유


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
username cbeane@domain.com String
familyName 예(사용자를 만드는 경우에만) 크레이그 String
givenName 예(사용자를 만드는 경우에만) 빈 (은) String
activeDirectoryMatchId 아니오 craig.beane@domain.com String
전자 메일 아니오 cbeane@domain.com 전자 메일
전화 아니오 +1234567890 Phone
sms 아니오 +1234567890 Phone
userNumber 아니오 14001 String
  • 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 형식으로 제공할 날짜 값입니다.
  • 학년 수준 ENUM의 들어오는 값(예: '1')에 누락된 선행 0은 정의된 값 목록(ENUM) '01'과 일치하며 '01'로 저장됩니다.

classes.csv

필드 필수 여부 예제 데이터 형식
sourcedId 12001 고유 ID
orgSourcedId 10001 고유 ID
title 컴퓨터 과학 101 String
sessionSourcedIds 아니요 FS2021 고유 ID[]
courseSourcedId 아니오 C12001 고유 ID
코드 아니오 12001 String
  • 이렇게 하려면 '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 String
schoolYearSourcedId 아니요 Y2021 고유 ID
subject 아니요 10 열거형
아니오 학부 열거형
  • 이렇게 하려면 orgSourcedId 필드를 사용하여 연결된 organization(조직)에 대한 참조가 필요합니다. 이렇게 하면 orgs.csv 파일에 대한 종속성이 생성됩니다.
  • 전달된 경우: 형식 = schoolYear인 'schoolYearSourcedId' 필드를 사용하여 연결된 학업 세션 연도 레코드에 대한 참조가 필요합니다. 이렇게 하면 academicSessions.csv 파일에 대한 종속성이 생성됩니다.
  • 학년 수준 ENUM의 들어오는 값(예: '1')에 누락된 선행 0은 정의된 값 목록(ENUM) '01'과 일치하며 '01'로 저장됩니다.

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 파일에 대한 종속성이 생성됩니다.