Apple School Manager로 데이터를 가져오기 위한 템플릿 정보
Apple School Manager에 데이터를 추가하려면 Apple 또는 OneRoster 형식의 .csv 템플릿 파일을 사용하면 됩니다.
Apple .csv 템플릿 이름: 학생, 직원, 강의, 수업, 명단, 장소
OneRoster .csv 템플릿 이름: 사용자, 강의, 수업, 등록, 조직
Apple 파일 이름 | OneRoster 파일 이름 | 내용 | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Apple: 학생 계정 정보가 들어 있습니다. OneRoster: 학생, 강사, 직원 계정 정보가 들어 있습니다. | |||||||||||
해당 없음 | 강사 등의 직원 계정 정보가 들어 있습니다. | ||||||||||
강의 정보가 들어 있습니다. | |||||||||||
강의 및 강사(직원) 정보가 들어 있습니다. | |||||||||||
수업, 학생 및 장소(명단) 정보가 들어 있습니다. | |||||||||||
장소(학교 또는 부서) 정보가 들어 있습니다. | |||||||||||
템플릿 및 관리형 Apple ID
person_number 또는 sis_username과 같은 선택 필드가 관리형 Apple ID 형식의 일부인 경우에는 필수 필드가 됩니다. 해당 필드를 비워 두면 MANAGED_ID_GENERATION_FAILED 오류와 함께 SFTP 업로드가 실패합니다.
템플릿 준비
템플릿을 준비할 때는 다음 기준을 충족해야 합니다.
students.csv 및 staff.csv 템플릿의 경우 모든 위치에 대해 person_id가 고유해야 합니다.
중요사항: SFTP를 사용하여 새 사용자를 업로드하고 할당한 person_id가 이미 다른 사용자에게 할당된 경우 새 사용자가 Apple School Manager의 기존 사용자를 덮어씁니다. 덮어쓰기가 완료된 후에는 SFTP를 통해서만 해당 사용자를 업데이트할 수 있습니다.
템플릿을 편집하는 경우 예시 데이터를 사용자 고유 데이터로 바꿔야 합니다. 각 파일에서 머리말 행의 내용은 변경하지 마십시오. 파일에 중복 열을 생성하지 마십시오. 특정 템플릿에 열을 추가할 수 있습니다.
모든 템플릿에서 각 행의 값이 고유해야 합니다. 예를 들어 students.csv 파일에서는 각 행에 고유한 학생이 있어야 합니다. 학생의 특정 값을 비워둘 수 있습니다. 리터럴 값(줄 바꾸기 또는 이름 안에 있는 따옴표 등)은 백슬래시(\)를 사용하여 이스케이프 처리해야 합니다. (예: \") 식별자를 입력할 때는 영숫자여야 하며 하이픈(-)을 포함할 수 있습니다.
값에 공백( )이나 쉼표(,)가 포함되어 있으면 곧은 따옴표(")로 묶습니다. 값에 특수 문자가 없으면 따옴표를 사용하지 마십시오. 따옴표가 있어야 하는 곳에 따옴표를 사용하지 않거나 둥근 따옴표를 사용하는 경우 업로드 과정에서 오류가 발생합니다.
파일 생성 방법에 상관없이 파일에서 값이 쉼표(,) 또는 세미콜론(;)으로 구분되어 있어야 합니다. 쉼표나 세미콜론 및 다음 값 사이에 공백 또는 탭을 사용하지 마십시오. 각 파일은 UTF-8로 인코딩되어야 합니다. 라인의 끝을 표시하려면 UNIX 새줄 문자 인코딩 \n을 사용하십시오.
이전 업로드에서 항목이 누락된 경우 다음과 같은 경우가 아니면 120일 후에 사용자 계정이 비활성화되고 자동으로 삭제됩니다.
사용자에게는 앱 또는 도서를 대량으로 구입한 역할이 있습니다.
사용자는 120일 제한 전에 수동으로 삭제됩니다.
CSV 파일의 이름이 원본 파일 이름과 정확하게 일치해야 합니다.
업로드하려면 모든 파일을 하나의 압축된(ZIP) 아카이브 파일로 만들어야 합니다.
압축된 아카이브 파일의 폴더 안에는 파일을 넣을 수 없습니다.
다른 CSV 파일에 대한 모든 외래 키 참조는 참조된 파일에 정의되어 있어야 합니다.
CSV 템플릿의 문자 제한
CSV 템플릿의 일부 필드는 허용되는 문자 수에 제한이 있습니다.
속성 이름 | 템플릿 | 문자 수 제한 |
|---|---|---|
Apple: first_name OneRoster: givenName | Apple: 학생, 직원 OneRoster: 사용자 | 32 |
Apple: middle_name OneRoster: middleName | Apple: 학생, 직원 OneRoster: 사용자 | 32 |
Apple: last_name OneRoster: familyName | Apple: 학생, 직원 OneRoster: 사용자 | 64 |
Apple: grade_level OneRoster: grades | Apple: 학생 OneRoster: 사용자 | 64 |
Apple: email_address OneRoster: email | Apple: 학생 OneRoster: 사용자 | 256 |
Apple: person_number OneRoster: identifier | Apple: 학생, 직원 OneRoster: 사용자 | 64 |
Apple: person_id OneRoster: sourcedId | Apple: 학생, 직원, 수업, 명단 OneRoster: 사용자, 수업, 등록 | 256 |
Apple: sis_username OneRoster: username | Apple: 학생, 직원 OneRoster: 사용자 | 256 |
Apple: class_id OneRoster: sourcedID | Apple: 수업, 명단 OneRoster: 수업, 등록 | 256 |
Apple: class_number OneRoster: classCode | Apple: 학생, 수업 OneRoster: 수업 | 64 |
Apple: course_id OneRoster: sourcedID | Apple: 강의, 수업 OneRoster: 강의, 수업 | 256 |
Apple: course_name OneRoster: title | Apple: 강의 OneRoster: 강의 | 128 |
Apple: course_number OneRoster: courseCode | Apple: 강의 OneRoster: 강의 | 64 |
Apple: location_name OneRoster: name | Apple: 장소 OneRoster: 조직 | 256 |
Apple: location_id OneRoster: sourcedID | Apple: 학생, 직원, 강의, 수업, 장소 OneRoster: 사용자, 강의, 수업, 조직 | 256 |