학생 추가 및 가져오기
Last updated: October 23, 2026
학생을 수동으로 추가하거나(학생 > +학생 추가 > 이름, 이메일, 국적, 현재 위치 필수 + 선택적 상담원; 저장하면 프로필이 자동 생성됨), 일괄 가져오기를 수행할 수 있습니다(관리자만 가능: 학생 > 점 3개 > 학생 가져오기 > 템플릿 다운로드 > 작성 > .csv > 업로드 > 구성 > 미리보기 > 가져오기). CSV 데이터 준비 및 일반적인 가져오기 오류에 대한 문제 해결 방법이 포함되어 있습니다.
학생을 한 번에 한 명씩 데이터베이스에 추가하거나, 대규모 그룹을 한 번에 가져올 수 있습니다.
학생 수동 추가
학생 섹션에서 한 번에 한 명씩 학생을 추가합니다.
접근 방법
왼쪽 메뉴의 학생 > 상단의 + 학생 추가.
필수 필드
- 학생 이름.
- 이메일 주소.
- 국적.
- 현재 위치.
생성 시 선택 사항
- 자신 또는 상담원에게 배정합니다.
다음 단계
저장을 클릭합니다. 시스템이 학생 프로필을 자동으로 생성하고 엽니다. 생성 중 입력한 정보가 미리 입력됩니다.
학생 페이지에서 프로필의 나머지 정보를 작성합니다(성별, 전화번호, 생년월일, 전체 주소, 여권, 비자 유형 등).
학생 일괄 가져오기
학생을 개별적으로 추가하는 대신 대규모 그룹을 한 번에 가져옵니다.
권한
관리자만 학생을 가져올 수 있습니다.
단계
- 학생 > + 학생 추가 옆의 점 3개 아이콘 > 학생 가져오기로 이동합니다.
- 가져오기 템플릿을 다운로드합니다.
- 학생 데이터로 템플릿을 작성합니다.
.csv파일로 저장합니다.- 업로드 버튼을 통해 업로드합니다.
- 가져오기 설정을 구성합니다:
- 중복 처리. 기존 이메일을 건너뛰거나 동일한 이메일을 가진 기존 학생을 덮어씁니다.
- 사무실. 대상 사무실을 선택합니다.
- 사용자에게 배정. 상담원을 선택합니다.
- 사용자 지정 필드. 추가 정보를 입력합니다(모든 레코드를 기존 사용자 지정 필드 값에 일괄 할당하는 것으로 제한됨).
- 검토하려면 가져오기 미리보기를 클릭합니다.
- 시작하려면 학생 가져오기를 클릭합니다.
중요. 가져오기가 완료될 때까지 브라우저 탭을 닫지 마세요.
CSV의 필수 필드
| 필드 | 유형 | 필수 |
|---|---|---|
| 이름 | 텍스트 | 예 |
| 성 | 텍스트 | 아니요 |
| 이메일 | 텍스트 | 예 |
| 선호 이름 | 텍스트 | 아니요 |
| 전화번호 | 텍스트 | 아니요 |
| 주소 | 텍스트 | 아니요 |
| 우편번호 | 텍스트 | 아니요 |
| 국적 | 국가 코드(MX, BR, FR) | 예 |
| 메모 | 텍스트 | 아니요 |
| 생년월일 | YYYY-MM-DD | 선택 사항, 엄격한 형식 |
| pipelineStageId | 숫자 | 공란 = 할당되지 않음 |
데이터 준비 및 문제 해결
성공적인 가져오기를 위해서는 깨끗한 데이터가 매우 중요합니다. 사소한 오류라도 전체 가져오기를 중단시킬 수 있습니다.
데이터 정리
- 불필요한 문자나 공백을 정리합니다.
- 날짜를
YYYY-MM-DD형식으로 지정합니다. - 모든 이메일에
@이 포함되어 있고 형식이 올바른지 확인합니다. - 제목은 있지만 값이 없는 열을 제거합니다(예: pipelineStageIds를 가져오지 않는 경우 해당 열을 완전히 제거).
- 스프레드시트 하단의 모든 빈 행을 삭제합니다.
.csv로 저장합니다.
일반적인 오류 및 해결 방법
| 증상 | 가능한 원인 | 해결 방법 |
|---|---|---|
| 미리보기에 학생 총계: 0이 표시됨 | 빈 행 또는 서식 오류 | 빈 행을 삭제하고 CSV로 다시 내보냅니다 |
| 제출 후 오류 메시지가 표시됨 | 권한 또는 잘못된 데이터 | 사용자에게 가져오기 사무실에 액세스할 권한이 있는지 확인합니다 |
| 날짜 오류 | 잘못된 날짜 형식 | 엄격한 YYYY-MM-DD 형식을 사용합니다 |
| 국적을 인식할 수 없음 | 잘못된 국가 코드 | 2자리 ISO 코드(예: MX, BR, FR)를 사용합니다 |
| 중복 이메일 오류 | 기존 학생 | 가져오기 설정에서 건너뛰기 또는 덮어쓰기를 선택합니다 |
권한 요구 사항
스프레드시트의 모든 할당 사용자(에이전트)는 가져오기 사무실에 액세스할 수 있는 올바른 권한을 가지고 있어야 합니다.
모범 사례
- 1,000명 이상을 가져오기 전에 소규모 배치(학생 5~10명)로 테스트합니다.
- 참조를 위해 가져오기 템플릿을 열어 둡니다.
- 가져오는 동안 브라우저를 닫지 마세요.
- 완료 후 가져오기 결과를 확인합니다(학생 총계).