일괄 사용자 추가 문제 해결하기

여러 고객과 파트너가 사용자 목록을 일괄 방식으로 추가할 때 문제를 보고했습니다. 대부분의 문제는 잘못된 형식의 CSV 파일에서 발생합니다. 일괄 추가 기능이 예상대로 작동하도록 아래 지침을 정확히 따르세요.

알아두기

v2.10부터 BioStar Air는 잘못된 항목이 포함된 CSV 파일을 업로드할 경우 검증 보고서를 반환합니다. 오류를 수정한 후 파일을 다시 업로드하세요.

CSV 파일 준비

CSV 템플릿의 정확한 형식 사용

관리 포털에서 템플릿을 다운로드하세요.

User Management → Users → + Add User → Import Users → Download
열(column)을 수동으로 추가하거나 삭제하지 마세요. 예기치 않은 열(column)이 있다면 오류가 발생할 수 있습니다.
추가 필드(예: 직원 ID 또는 부서)를 포함해야 한다면, User Template Settings로 이동하여 해당 필드를 추가합니다. 추가하면 다운로드한 CSV 파일에 자동으로 나타납니다.

사용자 아이디

각 사용자의 고유한 숫자 ID입니다.
이 열을 비워둘 수 있으며 시스템에서 자동으로 값을 할당합니다.
사용자 아이디를 직접 작성하는 경우
- 숫자만 사용하세요.
- 고유한 값을 사용하세요.
- 문자, 공백, 하이픈 또는 특수 문자를 포함하지 마십시오

중요

회사별 (문자를 포함한) 직원 ID를 사용하려 한다면 User Key 필드를 사용하지 마세요. 대신 User Template Settings을 사용해 별도의 커스텀 사용자 필드를 만드세요.

이메일 주소

유효한 이메일 형식을 따라야 합니다. 아래 유효성 검사 수식을 참고하세요.
- 공백 없음
- @ 포함
- 도메인에 . 및 최상위 도메인 포함(example.com, gmail.com, suprema.co.kr)
- 주소 뒤에 추가 마침표 없음
- 특수 문자 또는 숨겨진 문자 없음
- 이메일 주소여야 합니다. '제공하지 않음' 또는 '제공되지 않음'과 같은 오류가 발생할 수 있습니다.
고유해야 합니다. 파일 내 또는 기존 사용자 간에 중복을 허용하지 않습니다.
아래 크리덴셜을 발급받는다면 이메일 주소는 필수입니다.
- Mobile credential
- LinkPass
- QR code credential
사용자가 RFID 카드만 가지고 있다면 이메일 주소는 필요하지 않습니다.

전화번호

SMS를 통해 크리덴셜을 전달하지 않는다면 선택 사항입니다.
이메일 주소와 마찬가지로 고유해야 하며, 파일 내 또는 기존 사용자 간에 중복을 허용하지 않습니다.
크리덴셜 전달을 전달할 때는 이메일을 권장합니다. SMS 메시지는 추가 요금이 발생합니다.

날짜

모든 날짜(예: 발급일 또는 만료일)는 아래와 같은 정확한 형식을 따라야 합니다.

YYYY-MM-DDTHH:MM:SS.sssZ

Example:
1995-05-09T00:00:00.000Z

'Z'를 누락하거나, 대시(—) 대신 슬래시(/)를 사용하거나, 시간을 생략하는 등 사소한 차이도 업로드를 실패할 수 있습니다.

크리덴셜 요구 사항

크리덴셜 형식	이메일 또는 전화번호 필요?
RFID Only	아니요.
Mobile / LinkPass / QR	예, 하나가 필요합니다.

크리덴셜은 이메일 주소 또는 전화번호로 전달되어야 합니다.
둘 다 제공할 수 있지만 모바일 형식의 크리덴셜에는 최소 하나가 필요합니다.
이메일은 무료입니다. SMS는 요금이 부과됩니다.

사전 검증을 위한 엑셀 수식

데이터를 업로드하기 전에 helper columns에서 다음 수식을 사용하여 데이터를 확인할 것을 권장합니다.

Detect Duplicate Emails or Phone Numbers
=IF(E2="", "", IF(COUNTIF(E$2:E2, E2)>1, "Duplicate", "First Occurrence"))

Validate ISO 8601 Date Format (Column Q)
=IF(Q2="", "", IF(AND(LEN(Q2)=24, 
  ISNUMBER(VALUE(MID(Q2,1,4))), MID(Q2,5,1)="-", 
  ISNUMBER(VALUE(MID(Q2,6,2))), MID(Q2,8,1)="-", 
  ISNUMBER(VALUE(MID(Q2,9,2))), MID(Q2,11,1)="T", 
  ISNUMBER(VALUE(MID(Q2,12,2))), MID(Q2,14,1)=":", 
  ISNUMBER(VALUE(MID(Q2,15,2))), MID(Q2,17,1)=":", 
  ISNUMBER(VALUE(MID(Q2,18,2))), MID(Q2,20,1)=".", 
  ISNUMBER(VALUE(MID(Q2,21,3))), RIGHT(Q2,1)="Z"), 
  "Valid", "Invalid"))

Validate Email Format (Column E)
=IF(TRIM(E2)="", "", IF(AND(
  ISNUMBER(FIND("@", E2)),
  ISNUMBER(FIND(".", E2)),
  FIND("@", E2) > 1,
  FIND(".", E2, FIND("@", E2)) > FIND("@", E2) + 1,
  LEN(E2) - LEN(SUBSTITUTE(E2, "@", "")) = 1,
  ISERROR(FIND(" ", E2))
), "Valid", "Invalid"))

에러가 발생하나요?

올바른 템플릿을 다운로드하고 추가 열을 추가하지 않았습니까?
모바일 크리덴셜을 받는 사용자에 대한 모든 필수 필드가 작성되었습니까?
이메일 주소와 전화번호가 파일 및 기존 사용자 간에 고유합니까?
날짜 및 이메일 형식이 위에 지정된 대로 정확합니까?

참고

서비스팀은 파일 수정 서비스를 제공하지 않습니다. 파일이 업로드되지 않으면 위의 검증 도구를 사용하여 문제를 파악하고 해결하세요.

이 가이드는 서비스 팀의 수동 문제 해결 없이도 업로드를 성공적으로 완료할 수 있도록 돕기 위해 작성되었습니다.

CSV 파일 준비​

CSV 템플릿의 정확한 형식 사용​

사용자 아이디​

이메일 주소​

전화번호​

날짜​

크리덴셜 요구 사항​

사전 검증을 위한 엑셀 수식​

에러가 발생하나요?​