Skip to content

일괄 수여

일괄 수여를 사용하면 CSV 파일을 업로드해 수백 또는 수천 명의 수령자에게 한 번에 배지를 발급할 수 있습니다. 프로세스는 4단계이며 진행률 추적, 일시 정지/재개, 오류 처리가 기본 내장되어 있습니다.

개요

일괄 수여 프로세스는 4단계로 이뤄집니다.

  1. 구성 — 배지와 옵션 선택
  2. 업로드 — CSV 파일 준비 및 업로드
  3. 처리 — 수여가 생성되는 동안 진행 상황 모니터링
  4. 결과 — 결과 검토 및 리포트 다운로드

1단계: 구성

일괄 수여 — 1단계, 구성

  1. 사이드바에서 수여 페이지를 엽니다.
  2. 일괄 수여 를 클릭합니다.
  3. 배지 선택기를 사용해 수여할 배지를 고릅니다.
  4. 선택적으로 구성합니다.
    • 발급일 — 모든 수여에 사용할 날짜(기본값: 오늘)
    • 만료 — 모든 수여에 적용할 선택적 만료일
    • 이메일 보내기 — 각 수여가 생성된 후 자동으로 수령자에게 이메일을 보낼지 여부
  5. 다음 을 클릭합니다.

2단계: CSV 업로드

일괄 수여 — 2단계, 업로드

CSV 형식

CSV 파일에는 두 개의 열이 있어야 합니다: nameemail. 첫 행은 헤더여야 합니다.

csv
name,email
Jane Smith,jane@example.com
John Doe,john@example.com
Maria Garcia,maria@example.com

템플릿 다운로드

템플릿 다운로드 를 클릭해 올바른 헤더가 있는 빈 CSV 파일을 받으세요. 수령자를 채워 업로드합니다.

업로드

  1. CSV 업로드 를 클릭하거나 파일을 끌어다 놓습니다.
  2. 처리 시작 전에 파일이 검증됩니다.

검증 규칙

각 행은 다음과 같이 검증됩니다.

  • 이름 은 최소 5자
  • 이메일 은 유효한 이메일 주소여야 합니다
  • 파일 내 중복 이메일은 표시됩니다
  • 빈 행은 건너뜁니다

검증 오류가 발견되면 행 번호와 함께 표시됩니다. CSV의 문제를 수정한 뒤 다시 업로드하세요.

  1. 다음 을 클릭해 처리를 시작합니다.

3단계: 처리

처리가 시작되면 진행률 바와 실시간 상태가 표시됩니다.

  • 진행률 바 — 처리된 행의 비율
  • 현재 행 — 현재 처리 중인 행
  • 성공 수 — 생성된 수여 수
  • 오류 수 — 실패한 행 수

일시 정지 및 재개

  • 일시 정지 를 클릭해 처리를 잠시 중단합니다. 일시 정지 중에는 새 수여가 생성되지 않습니다.
  • 재개 를 클릭해 중단된 지점부터 계속합니다.

취소

  • 취소 를 클릭하면 처리가 완전히 중단됩니다. 이미 생성된 수여는 유지됩니다.

오류 처리

행이 실패하면(예: 잘못된 데이터, 월간 수여 할당량 도달):

  • 오류가 세부 내용과 함께 기록됩니다
  • 처리는 자동으로 다음 행으로 이동합니다
  • 실패한 행은 결과 단계용으로 수집됩니다

페이지 새로고침 복구

처리 중 실수로 브라우저를 닫거나 페이지를 새로고침해도, 다시 돌아오면 일괄 수여 세션이 복원됩니다. 진행률은 중단된 곳부터 다시 시작됩니다.

4단계: 결과

처리가 완료되거나 취소되면 결과 화면에 다음이 표시됩니다.

  • 총 처리 건수 — 시도한 행 수
  • 성공 — 생성된 수여 수
  • 실패 — 실패한 행 수

리포트 다운로드

  • 성공 CSV 다운로드 — 성공적으로 생성된 모든 수여의 CSV(수령자 이름, 이메일, 검증 URL 포함)
  • 실패 CSV 다운로드 — 실패한 모든 행과 오류 세부정보의 CSV

실패 재시도

일부 행이 실패한 경우, 실패 CSV를 다운로드해 문제를 수정한 뒤 새 일괄 수여로 다시 업로드하면 해당 수령자에 대해 재시도할 수 있습니다.

badges.ninja Documentation