> For the complete documentation index, see [llms.txt](https://docs.allganize.ai/allganize-alli-works/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.allganize.ai/allganize-alli-works/alli-dashboard/setting/permission/undefined.md).
# 멤버 일괄 다운로드 및 업로드
멤버 일괄 다운로드/업로드 기능을 사용하면 파일로 프로젝트 멤버를 한꺼번에 초대하거나 그룹을 변경할 수 있습니다.
| 기능 | 필요 권한 |
| ---------- | ----- |
| 멤버 목록 다운로드 | 멤버 읽기 |
| 멤버 일괄 업로드 | 멤버 쓰기 |
***
### 멤버 다운로드
#### 언제 사용하나요?
* 현재 프로젝트의 멤버 목록 전체를 파일로 받고 싶을 때
* 업로드용 기준 파일(템플릿)이 필요할 때
#### 사용 방법
1. 프로젝트 설정 > 멤버 관리 화면으로 이동합니다.
2. **멤버 다운로드** 버튼을 클릭합니다.
3. 파일 준비가 완료되면 다운로드 링크가 활성화됩니다.
4. 링크를 클릭해 XLSX 파일을 저장합니다.
> 파일 준비는 백그라운드에서 비동기로 처리됩니다. 멤버 수가 많은 경우 \~수 분이 소요될 수 있습니다.
#### 다운로드 파일 형식
파일명: `members.xlsx`
| 컬럼 | 설명 |
| ------- | ---------------- |
| `EMAIL` | 멤버 이메일 주소 |
| `GROUP` | 소속 권한 그룹 (쉼표 구분) |
> **주의:** 관리자(Admin) 그룹과 외부 연동 그룹은 다운로드 파일에 포함되지 않습니다.
***
### 멤버 업로드
#### 언제 사용하나요?
* 새 멤버를 여러 명 한꺼번에 초대할 때
* 여러 멤버의 그룹 구성을 일괄 변경할 때
#### 지원 파일 형식
`.xlsx` / `.csv` / `.tsv`
#### 파일 작성 규칙
**컬럼 구성**
| 컬럼명 | 필수 여부 | 설명 |
| ------- | ------ | ------------------------- |
| `EMAIL` | **필수** | 멤버 이메일 주소 |
| `GROUP` | 선택 | 권한 그룹명 (쉼표로 구분, 여러 그룹 가능) |
* 컬럼명은 대소문자를 구분하지 않습니다.
* `EMAIL`, `GROUP` 외의 컬럼은 전부 무시됩니다.
* 업데이트만 지원하며 멤버를 삭제하는 기능은 대시보드상에서만 가능합니다.
**GROUP 컬럼 동작 방식**
| GROUP 컬럼 상태 | 기존 멤버 | 결과 |
| ------------- | ----- | ------------------ |
| 컬럼 없음 | 기존 멤버 | 그룹 변경 없음 (SKIPPED) |
| 컬럼 있고 현재와 동일 | 기존 멤버 | 변경 없음 (SKIPPED) |
| 컬럼 있고 값 다름 | 기존 멤버 | 기존 그룹을 파일 값으로 덮어씀 |
| 컬럼 있고 셀 비어 있음 | 기존 멤버 | 기존 할당된 그룹 전부 제거 |
> **주의: 관리자 그룹 및 외부 연동 그룹은 업로드로 부여하거나 제거할 수 없습니다. 파일에 포함돼 있어도 자동으로 무시되며, 기존 멤버가 이미 해당 그룹에 속해 있다면 그대로 유지됩니다.**
#### 신규 멤버 동작
업로드로 새로 추가된 멤버에게는 **초대 이메일**이 자동 발송됩니다. `GROUP` 컬럼 유무와 무관하게 신규 멤버는 항상 초대 처리됩니다. 초대된 멤버는 이메일 링크를 통해 계정을 활성화하고 이름/언어 설정을 완료할 수 있습니다.
> 이메일 발송에 실패해도 업로드 자체는 성공으로 처리됩니다. 멤버 목록에서 개별 초대 재발송이 가능합니다.
#### 사용 방법
1. 프로젝트 설정 > 멤버 관리 화면으로 이동합니다.
2. **멤버 추가** > **파일로 추가** 를 선택합니다.
3. 준비된 파일(`.xlsx` / `.csv` / `.tsv`)을 선택합니다.
* `EMAIL` 컬럼이 없거나 지원하지 않는 파일 형식이면 즉시 오류가 표시됩니다.
4. 업로드가 시작되면 행(row)별 처리 결과가 실시간으로 표시됩니다.
5. 완료 후 성공/실패 건수를 확인합니다.
#### 행별 처리 결과
행 번호는 파일에서 보이는 번호와 동일합니다 (헤더가 0번, 첫 데이터 행이 1번).
| 상태 | 의미 |
| ----------------- | --------------------------- |
| `SUCCESS` | 멤버 생성 또는 그룹 업데이트 완료 |
| `SKIPPED` | 변경사항 없어 건너뜀 |
| `MISSING_EMAIL` | EMAIL 셀이 비어 있음 |
| `INVALID_EMAIL` | 이메일 형식 오류 또는 차단된 도메인 |
| `DUPLICATE_EMAIL` | 파일 내 동일 이메일 중복 (첫 번째 행만 처리) |
| `LIMIT_EXCEEDED` | 프로젝트 멤버 수 한도 초과 |
> `LIMIT_EXCEEDED`는 한도 내 행까지는 부분 적용됩니다.
***
### 자주 묻는 질문
**Q. 다운로드한 파일을 그대로 업로드하면 어떻게 되나요?**\
A. 모든 행이 `SKIPPED` 처리됩니다. 현재 상태와 동일하므로 변경이 발생하지 않습니다.
**Q. 존재하지 않는 그룹명을 입력하면 어떻게 되나요?**\
A. 해당 그룹명만 무시되고 행 전체는 정상 처리됩니다.
**Q. 이미 프로젝트에 있는 멤버를 업로드하면 재초대 이메일이 가나요?**\
A. 아니요. 초대 이메일은 신규 멤버 추가 시에만 발송됩니다.
**Q. 파일에 나 자신(관리자)이 포함되어 있으면 내 권한이 변경되나요?**\
A. 아니요. 관리자 권한은 업로드로 변경되지 않습니다.