가져오기 도구를 사용하여 쉼표로 구분된 값(CSV) 파일을 가져오려면 CSV 파일이 형식을 준수해야 하며 각 유형의 엔터티에 대한 정보를 포함해야 합니다. 이러한 파일은 Excel 스프레드시트에서 가져올 수 있습니다.
CSV 파일에 필요한 최소 정보
CSV 파일의 정보는 가져오기 도구에서 허용될 수 있도록 일관성이 있어야 합니다. 필요한 정보가 누락되면 바인딩 페이지의 다음 버튼이 비활성화됩니다. 가져온 엔터티의 각 유형에는 다음 표에 설명되어 있는 최소 정보 요구 사항이 있습니다.
엔터티 유형 | 필요한 최소 정보 |
---|---|
출입인증: 카드 | 다음과 같은 두 가지 출입인증 키를 선택할 수 있습니다.
사용자 지정 카드 형식을 선택하는 경우 카드 형식에 필요한 모든 필드가 CSV 파일의 열에 바인딩되어야 합니다. 그렇지 않으면 그 CSV 파일은 거부됩니다. 출입인증을 가져올 때 이 두 키 중 하나가 있어야 합니다. 두 키의 값이 모두 누락된 경우 줄이 삭제됩니다. 두 키가 모두 존재하는 경우 카드 데이터만 가져옵니다. |
출입인증: 번호판 | 카드홀더의 차량번호를 입력하십시오. Sharp 카메라가 차량 출입 장벽을 트리거하는 데 사용되는 경우, 이 방법을 사용하십시오. 이 경우, 카드홀더의 차량번호판을 크리덴셜로 사용할 수 있습니다. |
출입인증: PIN | PIN 출입인증은 카드 또는 독립형 출입인증으로 사용할 수 있습니다. 카드 및 PIN 모드로 리더기를 사용하려는 경우 각 카드홀더의 PIN이 고유해야 합니다. |
카드홀더 | 기본 카드홀더 키는 카드홀더의 성과 이름의 조합입니다. 카드홀더를 가져오려면 이 두 필드 중 하나를 CSV 열에 바인딩해야 합니다. 카드홀더를 가져오는 경우 모든 CSV 줄은 이 두 필드 중 하나 이상의 값을 가져야 합니다. 그렇지 않은 경우 줄이 삭제됩니다. |
카드홀더 그룹 | 카드홀더 그룹 이름만 필요합니다. 카드홀더 그룹이 누락되면 선이 삭제되지 않습니다. |
파티션 | 파티션 이름만 필요합니다. 파티션 이름이 누락되어도 줄은 삭제되지 않습니다. |
CSV 파일의 형식
다음은 가져올 새 카드홀더 3명을 포함하는 EmployeeData.csv라는 예제 파일입니다. Excel에서 .csv 파일로 저장하여 스프레드시트에서 만들 수 있습니다.
샘플 파일에는 다음 네 줄의 텍스트가 포함되어 있습니다.
#First name,Last name,Picture,Cardholder description,Cardholder email,
Cardholder group,Cardholder status,Credential name,Facility code,Card number,Credential status,Cardholder_activation,Cardholder_expiration, Credential_activation,Credential_expiration
Abdoulai,Koffi,D:\Tools\Import\WithPics\Koffi.jpg,Market Analyst,akoffi@genetec.com,Marketing,Yes,82968378,102,8,active,10-10-2018 7:00:00,10-20-2018 17:00:00,10-10-2018 7:00:00,10-20-2018 17:00:00
Andrew,Smith,D:\Tools\Import\WithPics\Smith.jpg,Sales Representative,asmith@genetec.com,Sales,Yes,82748590,101,12,active,10-12-2018 8:00:00,10-14-2018 17:00:00,10-12-2018 8:00:00,10-14-2018 17:00:00
Audrey,Williams,D:\Tools\Import\WithPics\Williams.jpg,Technical Writer,awilliams@genetec.com,TechWriters,Yes,83748952,104,18,active,10-13-2018 7:00:00,10-20-2018 18:00:00,10-13-2018 7:00:00,10-20-2018 18:00:00
첫 번째 행은 주석 행이며 CSV 파일에 포함된 카드홀더 및 출입인증 필드를 참조로 나열합니다. 다음 세 행은 가져올 필드를 포함합니다. Security Center에서 카드홀더 또는 출입인증에 대해 생성된 추가 사용자 지정 필드를 추가할 수 있습니다.
중요: 시간을 정의하지 않고 활성화 및 만료 날짜에 대한 열을 추가하는 경우 기본적으로 활성화 및 만료 날짜가 자정으로 설정됩니다. 특정 시간을 설정하는 경우 24시간을 사용하십시오.
사용 팁: 카드홀더 또는 크리덴셜 만료일 대신 첫 번째 사용 후 날짜 수 또는 카드홀더 또는 크리덴셜이 만료되는 비활성 날짜 수를 제공할 수 있습니다.
사용자 지정 필드에 대한 참고 사항 및 제한
CSV 파일에서 카드홀더와 크리덴셜 사용자 지정 필드 값을 가져올 때 다음에 유의하십시오.
- 텍스트 데이터 형식을 사용해 사용자 필드의 빈 필드를 가져오는 경우 기본값이 설정됩니다. 기본값 값이 정의되지 않은 경우 가져온 사용자 지정 필드가 비어 있게 됩니다.
- 텍스트 데이터 형식을 사용해 필수 및 고유 사용자 필드의 빈 필드를 가져올 경우 기존 값이 변경되지 않습니다.
다음 제한 사항이 있는 CSV 파일에서 카드홀더 및 출입인증 사용자 지정 필드 값을 가져올 수 있습니다.
- 엔터티 데이터 유형을 사용하여 사용자 지정 필드를 가져올 수 없습니다.
- 날짜 데이터 유형을 사용하는 사용자 지정 필드는 YYYY-MM-DD 형식으로 가져와야 합니다.
- 가져온 레코드별 사용자 지정 필드의 수가 증가하면 가져오기 도구 성능이 하락합니다.
- 레코드별 사용자 지정 필드 수가 많으면 동시에 가져올 수 있는 레코드 수가 제한될 수 있습니다. 예를 들어 레코드에 25KB 이미지 데이터 필드를 포함하여 각각 100개의 사용자 지정 필드가 포함되어 있으면 한 번에 1000개의 레코드만 가져올 수 있습니다.
- 사진을 가져온다면, CSV 파일에는 이미지 파일의 전체 경로가 포함되어야 합니다.