SFTP를 사용하여 Apple School Manager에 학생, 직원 및 수업 데이터 업로드하기
현재 SIS(학생 정보 시스템)가 Apple School Manager에서 지원되지 않거나 학생 정보 시스템이 없는 경우 SFTP를 사용하여 Apple School Manager에 학생, 직원 및 수업 데이터를 업로드할 수 있습니다.
SIS/SFTP 지원에서 SFTP를 설정하면 Apple School Manager에서 사설 SFTP 서버에 대한 접근 정보와 CSV 템플릿 파일을 제공해 줍니다. 지원되는 SIS에서 데이터를 내보내거나 Numbers와 같은 스프레드시트 응용 프로그램에서 파일을 생성할 수 있습니다. SIS에서 데이터를 내보내기 전에 SIS에 문의하여 Apple School Manager에 맞는 포맷인지 확인하십시오.
SFTP를 사용하여 업로드하려면 macOS에 타사 응용 프로그램을 설치해야 합니다. SFTP 클라이언트가 설치되어 있지 않은 경우 Mac App Store에서 찾을 수 있습니다.
아래 버튼을 사용하여 SFTP 파일 설치에 대한 도움말을 얻으십시오. SFTP를 사용하여 Apple School Manager에 데이터를 업로드해 본 적이 없는 경우 SFTP 업로드 처음 설정하기 섹션부터 시작해야 합니다.
SFTP 업로드 처음 설정하기
Apple School Manager에 책임자, 사이트 관리자 또는 사용자 관리자로 로그인합니다.
사이드바 하단에 있는 사용자 이름을 클릭하고 '환경설정', '계정', '디렉토리 동기화'를 차례로 클릭한 다음 SIS/SFTP 섹션에서 '활성화'를 선택합니다. SFTP를 설정하기 전에 먼저 도메인을 확인
'학생, 강사 및 수업 찾기'를 클릭합니다.
/locale/ko-kr/2022-asm-sftp-upload-data-setup-assistant-step-3.png)
'SFTP 설정'을 클릭합니다.
/locale/ko-kr/2022-asm-sftp-upload-data-find-students-staff-classes-step-4.png)
Apple School Manager에서 파일을 업로드할 때 사용할 URL, 사용자 이름 및 암호가 생성됩니다. 이 정보를 사용하여 SFTP 클라이언트를 구성합니다.
/locale/ko-kr/2022-asm-sftp-upload-data-sftp-info-step-5.png)
'템플릿 다운로드'를 클릭합니다.
'데이터 파일 작성하기' 섹션에서 템플릿 사용에 대한 지침을 읽습니다.
데이터 파일이 작성되면 총 6개 파일의 Zip 아카이브를 생성합니다. Finder에서 파일을 선택한 다음 파일 메뉴로 이동하여 '6개의 항목 압축'을 선택합니다. Zip 아카이브에 어떤 이름을 지정하든 상관없습니다.
Zip 파일을 Apple School Manager로 업로드합니다. SFTP 클라이언트를 사용하여 SIS/SFTP 지원에 표시된 URL에 연결합니다. 로그인 정보를 묻는 메시지가 표시되면 'SFTP 설정'을 클릭했을 때 받은 사용자 이름과 암호를 사용합니다. Zip 파일을 dropbox 디렉토리에 복사합니다.
SIS/SFTP 지원에서 '계속'을 클릭합니다. 업로드에 오류가 포함된 경우 오류가 포함된 파일과 줄을 식별하는 로그를 검토할 수 있습니다. 데이터 파일의 오류를 모두 수정한 후 8~9단계를 반복합니다. SFTP Server에서 이전 파일을 제거하지 않아도 됩니다.
SFTP 가져오기가 끝나면 'SFTP 데이터 검토'를 클릭합니다. 오류가 발견된 경우에는 '취소'를 클릭합니다. 데이터 파일에서 오류를 수정한 다음 업로드 절차를 반복합니다. 데이터가 정확하고 완전하면 '계속'을 클릭합니다.
/locale/ko-kr/2022-asm-sftp-upload-data-review-sftp-data-step-11.png)
계정과 수업 생성하기에서 학생, 강사 및 직원에 대해 관리형 Apple ID 형식을 선택합니다. '계정과 수업 미리보기'를 클릭합니다. ID가 올바른 형식이면 '계정과 수업 생성하기'를 클릭합니다. 확인된 도메인
/locale/ko-kr/2022-asm-sftp-upload-data-preview-accounts-step-12.png)
계정이 생성되면 로그인 정보를 사용자에게 배포하고 직원에게 역할을 할당합니다.
/locale/ko-kr/2022-asm-sftp-upload-data-done-step-13.png)
데이터 파일 작성하기
템플릿 다운로드에는 수업, 강의, 장소, 명단, 학생, 직원에 대한 6개의 쉼표로 분리된 값 파일(CSV)이 포함되어 있습니다. 템플릿을 Apple School Manager에서 사용할 수 없거나 원본 템플릿의 복사본을 분실한 경우 다시 다운로드할 수 있습니다.
SIS를 사용하여 템플릿과 이 문서에 설명된 형식으로 데이터를 보내거나 Numbers와 같은 스프레드시트 프로그램에서 템플릿을 편집할 수 있습니다.
이 문서의 표를 사용하여 올바른 정보를 입력했는지 확인한 다음 각 파일의 이름을 변경하지 않고 저장합니다.
값 서식 지정하기
템플릿을 편집할 경우 예제 데이터를 자신의 데이터로 바꿉니다. 각 파일에서 머리글 셀의 내용은 변경하지 마십시오. 아래에 설명되어 있는 경우를 제외하고 어떤 파일에도 열을 추가하지 마십시오.
모든 템플릿에서 각 행은 고유한 값이어야 합니다. 예를 들어 students.csv 안에서 각 행은 고유한 학생이어야 합니다. 해당 학생의 특정 값은 비워둘 수 있습니다. 이름 안의 줄 바꿈, 따옴표 문자와 같은 리터럴 값은 백슬래시(\)로 이스케이프해야 합니다(예: \"). 입력한 식별자는 영숫자여야 하며 '-' 기호를 사용할 수 있습니다.
값에 공백( ) 또는 쉼표(,)가 포함된 경우 양쪽에 곧은 따옴표(")를 추가하십시오. 값에 이러한 특수 문자가 없는 경우에는 따옴표를 사용하지 마십시오. 필요한 위치에 따옴표를 사용하지 않거나 둥근 따옴표를 사용할 경우 업로드 과정에서 오류가 발생하게 됩니다.
파일의 값은 파일을 생성한 방식과 상관없이 쉼표(,) 또는 세미콜론(;)으로 구분해야 합니다. 쉼표 또는 세미콜론과 그 다음 값 사이에 공백 또는 탭을 사용하지 마십시오. 각 파일은 UTF-8로 인코딩하고 Unix 줄 추가(\n)를 사용해야 합니다.
그 밖에 person_number, sis_username 등의 선택 사항 필드가 관리형 Apple ID 형식의 일부인 경우 해당 필드는 필수 필드가 됩니다. 필수 필드를 비워 두면 업로드에 실패하고 MANAGED_ID_GENERATION_FAILED 오류가 표시됩니다.
장소 파일
location_id | 공백이 없는 숫자 또는 글자로 구성된 고유한 식별자입니다. | 필수 |
location_name | 장소 이름입니다. | 필수 |
장소 파일에 하나 이상의 장소를 정의해야 합니다. SFTP를 사용하여 주요 '본관' 장소에 학생 또는 직원 계정을 생성할 수 없습니다.
학생 파일
SFTP를 사용하여 새로운 사용자를 업로드하는데 person_id가 이미 Apple School Manager에 있는 경우 새로운 사용자가 Apple School Manager에 있는 기존 사용자를 덮어쓰게 됩니다. 덮어쓰기가 완료되면 SFTP를 통해서만 해당 사용자를 업데이트할 수 있습니다.
person_id | 특정 학생의 고유 식별자입니다. 이 person_id는 가능하면 SIS의 고유 식별자와 일치해야 합니다. 이 person_id는 Apple School Manager에서 학생의 고유 식별자입니다. 이 값을 사용하여 명단 파일에서 학생을 참조하고 수업 파일에서 강사를 참조합니다. | 필수 |
person_number | 학교의 학생을 식별할 수 있는 다른 값입니다. 학생 식별 번호일 수 있습니다. | 선택 사항 |
first_name | 학생의 이름입니다. | 필수 |
middle_name | 학생의 중간 이름입니다. | 선택 사항 |
last_name | 학생의 성입니다. | 필수 |
grade_level | 학생의 학년입니다. | 선택 사항 |
email_address* | 학생의 이메일 주소입니다. | 선택 사항 |
sis_username | SIS에서 학생의 사용자 이름입니다. | 선택 사항 |
password_policy | 각 학생에 대한 암호 정책을 지정하려면 password_policy 필드를 사용합니다. password_policy 필드에 숫자 4, 6 또는 8을 지정하거나 필드를 비워 두어야 합니다. 8을 선택하는 경우 표준 암호 정책(8자 이상의 문자와 숫자 조합)이 사용됩니다. 이 값은 장소 암호 정책 및 해당 학생에 대해 이전에 설정해 놓은 모든 암호 정책보다 우선적으로 적용됩니다. password_policy를 비워 둘 경우 새로운 학생에게는 장소에 대한 기본 암호 정책이 적용되며 기존 학생에게 설정된 암호 정책은 변경되지 않습니다. | 선택 사항 |
location_id | 학생의 location_id입니다. 이는 장소 파일의 location_id와 일치해야 합니다. 이 항목이 장소 파일의 항목과 일치하지 않는 경우 업로드 과정에서 문제가 발생하게 됩니다. | 필수 |
* 연합 인증 이메일 주소가 연합 도메인에 있는 경우 사용자 계정이 연합됩니다.
여러 장소 할당하기
Students(학생) 파일에 위치 열을 더 추가하여 한 학생에게 둘 이상의 위치를 할당할 수 있습니다. location_id_2, location_id_3와 같은 형식의 이름을 location_id_999까지 지정하여 최대 998개의 장소 열을 추가할 수 있습니다. 각 학생의 장소 열 각각에 다른 location_id를 선택적으로 입력할 수 있습니다. 이는 장소 파일의 location_id와 일치해야 합니다. 이 항목이 장소 파일의 항목과 일치하지 않는 경우 업로드 과정에서 문제가 발생하게 됩니다.
직원 파일
SFTP를 사용하여 새로운 교직원을 업로드할 때 할당한 person_id가 이미 Apple School Manager에 있는 경우 새로운 사용자가 Apple School Manager에 있는 기존 사용자를 덮어씁니다. 덮어쓰기가 완료되면 SFTP를 통해서만 해당 사용자를 업데이트할 수 있습니다. 모든 직원에게 표준 암호 정책(8자 이상의 문자와 숫자 조합)이 적용됩니다.
person_id | 특정 직원의 고유 식별자입니다. 이 person_id는 가능하면 SIS의 고유 식별자와 일치해야 합니다. person_id는 Apple School Manager에서 해당 직원의 고유 식별자입니다. 이 값을 사용하여 수업 파일에서 강사를 참조합니다. | 필수 |
person_number | 학교의 직원을 식별할 수 있는 다른 값입니다. 직원 배지 번호일 수 있습니다. | 선택 사항 |
first_name | 직원의 이름입니다. | 필수 |
middle_name | 직원의 중간 이름입니다. | 선택 사항 |
last_name | 직원의 성입니다. | 필수 |
email_address* | 직원의 이메일 주소입니다. | 선택 사항 |
sis_username | SIS에서 직원의 사용자 이름입니다. | 선택 사항 |
location_id | 직원의 location_id입니다. 이는 장소 파일의 location_id와 일치해야 합니다. 이 항목이 장소 파일의 항목과 일치하지 않는 경우 업로드 과정에서 문제가 발생하게 됩니다. | 필수 |
* 연합 인증 이메일 주소가 연합 도메인에 있는 경우 사용자 계정이 연합됩니다.
여러 장소 할당하기
직원 파일에 장소 열을 더 추가하여 한 명의 직원에게 둘 이상의 장소를 할당할 수 있습니다. location_id_2, location_id_3와 같은 형식의 이름을 location_id_999까지 지정하여 최대 998개의 장소 열을 추가할 수 있습니다. 각 직원의 장소 열 각각에 다른 location_id를 선택적으로 입력할 수 있습니다. 이는 장소 파일의 location_id와 일치해야 합니다. 이 항목이 장소 파일의 항목과 일치하지 않는 경우 업로드 과정에서 문제가 발생하게 됩니다.
강의 파일
course_id | 강의의 고유 식별자입니다. 이는 수업 파일에 사용된 해당 course_id와 일치해야 합니다. | 필수 |
course_number | 강의의 번호입니다. 이 번호는 SIS 또는 교육 과정 안내서의 강의 번호일 수 있습니다. | 선택 사항 |
course_name | 강의 이름입니다. | 선택 사항 |
location_id | 강의의 location_id입니다. 이는 장소 파일의 location_id와 일치해야 합니다. 이 항목이 장소 파일의 항목과 일치하지 않는 경우 업로드 과정에서 문제가 발생하게 됩니다. | 필수 |
수업 파일
class_id | 수업의 고유 식별자입니다. | 필수 |
class_number | 조직에서 수업을 식별하는 번호 또는 코드입니다. class_id와 달리 class_number는 CSV 명단에서 이 수업을 참조하는 데 사용되지 않습니다. | 선택 사항 |
course_id | 이 수업이 속한 강의의 course_id입니다. 이는 강의 파일의 course_id와 일치해야 합니다. | 필수 |
instructor_id | 강사의 person_id입니다. 이는 직원 파일에 사용된 해당 person_id와 일치해야 합니다. | 선택 사항 |
instructor_id_2 | 강사의 person_id입니다. 이는 직원 파일에 사용된 해당 person_id와 일치해야 합니다. | 선택 사항 |
instructor_id_3 | 강사의 person_id입니다. 이는 직원 파일에 사용된 해당 person_id와 일치해야 합니다. | 선택 사항 |
location_id | 수업의 location_id입니다. 이는 장소 파일의 location_id와 일치해야 합니다. 이 항목이 장소 파일의 항목과 일치하지 않는 경우 업로드 과정에서 문제가 발생하게 됩니다. | 필수 |
여러 명의 강사 할당하기
수업 파일에 강사 열을 더 추가하여 한 수업에 네 명 이상의 강사를 할당할 수 있습니다. instructor_id_4, instructor_id_5와 같은 형식의 이름을 instructor_id_15까지 지정하여 최대 12개의 강사 열을 추가할 수 있습니다. 각 수업에 해당 강사의 다른 person_id를 선택적으로 입력할 수 있습니다. 이는 직원 파일에 사용된 해당 person_id와 일치해야 합니다.
명단 파일
roster_id | SIS 또는 다른 강의 데이터베이스(있는 경우)의 명단의 고유 식별자입니다. | 필수 |
class_id | 수업의 고유한 영숫자 식별자입니다. 이는 수업 파일의 class_id와 일치해야 합니다. | 필수 |
student_id | 학생 1명에 대한 person_id입니다. | 필수 |
명단 파일은 학생을 해당 수업에 추가하는 데 사용됩니다. 파일의 각 줄에는 고유한 roster_id가 있어야 하며, class_id와 person_id가 각각 한 개씩만 포함되어야 합니다.
파일 업데이트하기
학생, 직원 및 수업을 추가하거나 편집하려는 경우 데이터 파일을 편집하여 새 사본을 업로드합니다. 파일을 업로드할 때마다 6개 파일을 모두 업로드해야 하며, 각 파일에는 추가하려는 항목뿐만 아니라 각 범주의 전체 목록이 포함되어야 합니다. 설정 > 데이터 소스를 선택하여 SFTP 계정 정보를 확인할 수 있습니다.
Apple School Manager에서 SFTP 연결을 끊으면 계정과 수업이 수동으로 변경됩니다. 이 문제를 해결하려면 SFTP 연결을 복원하고 새로 업로드하십시오.
첫 업로드 이후에는 업로드할 때 새 계정과 수업이 자동으로 생성됩니다. 오류가 있으면 Apple School Manager에서 이메일을 보내 알려 줍니다.
이전 업로드 항목이 유실되는 경우
이전 업로드 항목이 유실되면 해당 계정에서 콘텐츠를 대량으로 구입하지 않은 경우 120일 후에 계정이 비활성화되고 자동으로 삭제됩니다.
강의 또는 수업이 제거되는 경우
강의나 수업이 업로드에서 제거되면 학생이 수업에서 제거되고 소스가 '수동'으로 변경됩니다. 스쿨워크에서 강의를 사용 중인 경우 명단이 제거되므로 재등록을 위해서 강의를 새로 개설해야 합니다. 스쿨워크에서 수업을 사용 중인 경우 진도 데이터가 자동으로 삭제되어 교사나 학생이 더 이상 진도를 확인할 수 없게 됩니다.
소스가 수동으로 변경된 강의와 수업은 계속 MDM 솔루션과 동기화되지만, 더 이상 교실 앱에 나타나지 않습니다. Apple School Manager에서 해당 수업을 삭제하면 됩니다.
Apple이 제조하지 않은 제품에 관한 정보 또는 Apple의 관리 또는 테스트 대상이 아닌 독립적인 웹 사이트는 권장 또는 보증 없이 제공되는 것입니다. Apple은 타사 웹 사이트 또는 제품에 대한 선택, 성능 및 사용과 관련하여 발생하는 결과에 대해 책임을 지지 않습니다. Apple은 타사 웹 사이트의 정확성 또는 신뢰도에 대해 어떠한 언급도 하지 않습니다. 자세한 내용은 해당 업체에 문의하시기 바랍니다.
