Apple School Manager로 기록을 가져오기 위한 템플릿 정보
Apple은 데이터를 사용자 위치에 추가할 때 사용하는 다음과 같은 6가지 템플릿을 제공합니다:
학생(Students): 학생 계정 정보가 들어 있습니다.
직원(Staff): 강사 등의 직원 계정 정보가 들어 있습니다.
강의(Courses): 강의를 정의합니다.
수업(Classes): 강의 및 강사(직원) 정보가 들어 있습니다.
명단(Rosters): 수업, 학생 및 장소 정보가 들어 있습니다.
장소(Locations): 장소 정보가 들어 있습니다.
템플릿 및 관리형 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일 후에 자동으로 삭제됩니다.
CSV 파일의 이름이 원본 파일 이름과 정확하게 일치해야 합니다.
업로드하려면 모든 파일을 하나의 압축된(ZIP) 아카이브 파일로 만들어야 합니다.
압축된 아카이브 파일의 폴더 안에는 파일을 넣을 수 없습니다.
다른 CSV 파일에 대한 모든 외래 키 참조는 참조된 파일에 정의되어 있어야 합니다.
CSV 템플릿의 문자 제한
CSV 템플릿의 일부 필드는 허용되는 문자 수에 제한이 있습니다.
필드 | 템플릿 | 문자 수 제한 |
---|---|---|
first_name | 학생, 직원 | 32 |
middle_name | 학생, 직원 | 32 |
last_name | 학생, 직원 | 64 |
grade_level | 학생 | 64 |
email_address | 학생 | 256 |
person_number | 학생, 직원 | 64 |
person_id | 학생, 직원, 수업, 명단 | 256 |
sis_username | 학생, 직원 | 256 |
class_id | 수업, 명단 | 256 |
class_number | 수업 | 64 |
course_id | 강의, 수업 | 256 |
course_name | 강의 | 128 |
course_number | 강의 | 64 |
location_name | 장소 | 256 |
location_id | 학생, 직원, 강의, 수업, 장소 | 256 |