Search

ADT캡스 연동 가이드

연동 시작 전 꼭 확인해주세요.
ADT캡스 연동은 ADT캡스의 “외부전송 DB” 기능을 사용해 이루어집니다.
회사의 담당 ADT캡스 엔지니어 분께 “외부전송 DB 기능을 사용해 외부 서비스와 근태 기록을 연동하려는데 지원이 필요하다”고 요청 시 보다 원활한 연동 진행이 가능합니다.
아래의 1-2단계 진행 중 직접 해결하기 어려운 상황을 만나셨을 때도 마찬가지입니다.
사용하는 ADT캡스 제품 및 버전에 따라 스크린샷과 실제 화면 간 차이가 존재할 수 있습니다.
설치된 Remote Access Manager 프로그램이 “외부전송 DB” 기능 미지원 시 연동이 어렵습니다.
그 외에 초기 연동 진행 중 어려움을 만나신다면 먼저 자주 묻는 질문을 참고해주세요.
원활한 연동 진행을 위해 아래 두 가지 조건이 만족된 상태인지 먼저 확인하세요.
‘세콤/ADT캡스 연동’ 부가서비스를 구독하고 있어야 합니다.
아직 구독 이전 상태라면 먼저 채널톡을 통해 문의하세요.
‘세콤/ADT캡스 연동’ 권한이 있어야 합니다.
권한이 없다면 회사 내 flex 권한 관리자에게 문의하세요.

개요

ADT캡스와 flex를 연동해, 출입관리기기의 출·퇴근 기록을 flex 시스템의 출·퇴근 기록으로 연동할 수 있습니다.
ADT캡스 연동 설정은 총 4단계로 이루어집니다.
1.
flex DB 접근 설정
2.
ADT캡스 출퇴근기록 내보내기 설정
3.
ADT캡스 사용자와 flex 사용자 매핑을 위한 사번 설정
4.
등록 활성화 및 연동 확인

0. 사전 준비

(Fig 0.a) 시작 메뉴를 통해 두 프로그램이 정상적으로 설치된 상태인지 확인
ADT캡스 출퇴근기록이 저장되는 서버에는 다음 두 프로그램이 이미 설치된 상태일 것입니다. (Fig 0.a)
Access Server Manager : 항상 실행 중인 ADT캡스 서버 프로그램
Remote Access Manager (ADT캡스 엑세스 가드)
위 두 프로그램이 정상적으로 설치된 상태인지 확인해주세요. 만약 찾을 수 없다면 ADT캡스 담당자에게 문의하세요.

1. flex DB 접근 설정

먼저 기록 동기화를 위한 flex DB에 접근하기 위해 필요한 설정을 진행합니다. 진행을 위해 플렉스팀에서 도입 문의 시 제공해드린 계정 정보가 필요합니다.

1.1. PostgreSQL ODBC Driver 설치

아래 파일을 다운로드 받고, 압축을 풀어 설치하세요.
psqlodbc_15_00_0000-x86.zip
3875.1KB
만약 공식 경로에서 직접 다운로드 받는 걸 선호한다면 아래 내용을 참고하세요 (파일은 동일합니다)

1.2. 시스템 DSN 추가

(Fig 1.2.a) 시작 메뉴 검색을 통해 ODBC 데이터 원본 (32비트) 프로그램을 찾아 실행
ODBC 데이터 원본 (32비트) (언어 설정이 영어일 시 ODBC Data Source (32-bit)) 프로그램을 찾아 실행하세요. (Fig 1.2.a)
(Fig 1.2.b) ODBC 데이터 원본 (32비트) 프로그램에서 시스템 DSN 추가
프로그램이 실행되면 다음 단계를 따라하세요. (Fig 1.2.b)
1.
‘시스템 DSN’ 탭으로 이동
2.
‘추가’ 버튼 선택
3.
‘새 데이터 원본 만들기’에서 PostgreSQL Unicode 선택
만약 PostgreSQL Unicode 가 보이지 않는다면 1.1.1. 단계의 설치가 정상적으로 완료되었는지 확인하세요.

1.3. DB 접속 정보 설정

(Fig 1.3.a) PostgreSQL Unicode 선택 후 안내에 따라 정보 입력
(Fig 1.3.a) PostgreSQL Unicode 선택 후 안내에 따라 정보 입력
(Fig 1.3.b) ‘Asia/Pacific (Seoul)’ 리전의 ‘인증서 번들(PEM)’ 파일 다운로드
PostgreSQL Unicode 를 선택하면 나오는 화면에 다음과 같이 정보를 입력하세요. (Fig 1.3.a)
1.
Data Source : ACCESSENTER 를 입력해주세요. 다른 값으로 입력하면 연동이 되지 않으니 정확히 입력하세요.
2.
Description : flex ADT캡스 연동 등, 식별을 위한 설명을 자유롭게 입력하세요. (필수 아님)
3.
Database / Server / Port / User Name / Password : flex에서 제공받은 파일에 포함된 내용을 입력하세요.
Database : 전달드린 파일의 데이터베이스
Server : 전달드린 파일의 서버
Port : 전달드린 파일의 port
User Name : 전달드린 파일의 사용자 이름
Password : 전달드린 파일의 비밀번호
4.
SSL Mode : require 를 선택 후, 정보 입력창의 우측 하단 ‘Test’ 버튼을 클릭하세요. 만약 ”Connection successful” 메시지가 확인되면 ‘Save’ 버튼을 클릭하고 ACCESSENTER 시스템 DSN이 추가된 걸 확인한 후, ODBC 데이터 원본 (32비트) 프로그램을 종료 후 다음 단계로 넘어가세요. 만약 오류 메시지가 나타난다면 다음 과정을 따라하세요.
a.
먼저 보안 연결을 위한 인증서 파일을 설치합니다.
‘Asia/Pacific (Seoul)’ 리전의 ‘인증서 번들(PEM)’ 파일을 내려받습니다. (Fig 1.3.b)
a.
정보 입력창의 우측 하단 ‘Test’ 버튼을 클릭하여 오류 메시지를 확인합니다.
오류 메시지에 다음과 유사한 파일 경로가 포함되어 나옵니다.
C:\Users\Administrator\AppData\Roaming\postgresql\root.crt
C:\사용자\{사용자명}\AppData\roaming\postgresql\root.crt
기기마다 파일 경로가 달라질 수 있으니, 꼭 오류 메시지에 적힌 경로를 확인하세요.
b.
a. 에서 다운로드 받은 파일을 위 에러 메시지에 표시된 경로로 옮깁니다.
이동 전 또는 후에 에러 메시지에 표시된 파일명 (위 예시의 경우 root.crt) 과 동일하게 다운로드 받은 파일의 이름을 변경하세요.
이 때, AppData 폴더가 탐색기에서 보이지 않는다면 숨김 해제가 필요할 수 있습니다.
(Fig 1.3.c) 연결 설정 확인 및 저장
마지막으로 연결 설정을 확인합니다. (Fig 1.3.c)
1.
하단의 ‘Test’ 버튼을 클릭해 정상적으로 연결이 완료되었음을 나타내는 연결 성공 메시지가 표시되는지 확인하세요.
2.
‘Save’ 버튼을 클릭하고 ACCESSENTER 시스템 DSN이 추가된 걸 확인한 후, ODBC 데이터 원본 (32비트) 프로그램을 종료하세요.

2. ADT캡스 출퇴근기록 내보내기 설정

1단계를 통해 flex가 제공하는 DB에 접근할 준비가 끝났습니다. 다음으로, ADT캡스에 쌓이는 출입기록을 준비된 DB로 내보내도록 설정합니다.

2.1. Remote Access Manager 실행

(Fig 2.1.a) Remote Access Manager (ADT캡스 엑세스 가드) 실행
(Fig 2.1.b) 로그인 창의 ‘마스터 관리자 로그온’ 체크박스 체크
Remote Access Manager (ADT캡스 엑세스 가드) 프로그램을 실행합니다. (Fig 2.1.a)
이 때, ‘마스터 관리자 로그온’ 체크박스를 선택한 채로 로그인하세요. (Fig 2.1.b)

2.2. 외부전송 DB 설정

(Fig 2.2.a) Remote Access Manager (ADT캡스 엑세스 가드) 상단 툴바의 ‘서버 관리 ‣ 서버 옵션 설정’ 메뉴의 ‘외부전송 DB’ 탭
로그인 후 아래 순서를 따라 외부전송 DB 설정을 진행하세요.(Fig 2.2.a)
1.
상단 툴바에서 ‘서버 관리 ‣ 서버 옵션 설정’ 메뉴를 선택합니다.
2.
‘서버 옵션 설정’ 화면이 열리면 ‘외부전송 DB’ 탭으로 이동합니다.
3.
flex에서 제공한 계정 / 암호를 입력 뒤, ‘DB 접속’ 버튼을 클릭합니다.
계정: 전달드린 파일의 사용자 이름 (1.3 단계에서 입력한 User Name과 동일한 값)
암호: 전달드린 파일의 비밀번호 (1.3 단계에서 입력한 Password와 동일한 값)
‘DB 접속’ 버튼을 클릭 후 ‘테이블 선택’ 영역에 옵션 목록이 표시되면 caps_event를 선택합니다.
만약 테이블 목록이 표시되지 않거나 caps_event 를 찾을 수 없다면 플렉스팀에 문의하세요.
4.
열 선택 : 좌측 이미지(Fig 2.2.a)에 보이는 그대로 설정합니다.
이미지에 표시된 열이름 항목에 대해서는 표시된 대로의 원본선택 값을 선택합니다.
이미지에 표시되지 않은 열이름 항목에 대해서는 원본선택 을 건드리지 않고 빈 채로 내버려둡니다.
원본선택 을 지정하지 않은 열이름 항목은 최초 저장 시 지워집니다.
실수로 필요한 항목을 지웠다면 3번 ‘DB 접속’ 버튼을 다시 눌러 초기화할 수 있습니다.
’열이름’, ‘원본선택’ 값이 스크린샷과 정확히 동일한지 꼭 한 번 더 확인해주세요.
예를 들어, ‘열이름’ event_date 가 아닌 e_date 등 가이드와 다른 값이 표시되거나, 일자 외의 다른 ‘원본선택’과 연결되면 연동이 제대로 동작하지 않습니다.
스크린샷과 다른 ‘열이름’ 들이 표시된다면 ‘DB 접속’ 버튼을 다시 클릭한 후, ‘테이블 선택’ 선택기를 한 번 더 열어서 caps_event 를 재선택하세요.
5.
근태 내역 옵션 (공통) / 날짜 시간 옵션 (공통) : 마찬가지로 첨부 이미지와 동일한 값으로 설정합니다.
6.
모든 입력을 마쳤다면 우측 하단의 ‘변경’ 버튼을 눌러 저장한 뒤 메뉴를 빠져나옵니다.

3. ADT캡스 사용자와 flex 사용자 연결을 위한 사번 설정

2단계를 마쳤다면 ADT캡스에 남는 출입기록이 flex DB에 동기화됩니다. 다음으로, ADT캡스 사용자와 flex 사용자를 연결하기 위한 사번 정보를 설정합니다.
(Fig 3.a) Remote Access Manager (ADT캡스 엑세스 가드) ‘사용자’ 메뉴
근태 기록 연동을 원하는 사용자 별로 사원번호 설정이 필요합니다.
‘사용자’ 메뉴를 선택한뒤 목록에서 각 사용자 별로 ‘기본정보 > 사원번호’ 필드에 flex 제품 내에 설정된 사번과 동일한 값을 입력하고 저장하세요. (Fig 3.a)
(Fig 3.b) flex ‘구성원’ 메뉴
(Fig 3.c) flex 구성원 프로필
flex 제품 내에 설정된 사번 값은 구성원 페이지 (Fig 3.b) 또는 구성원 프로필 (Fig 3.c) 에서 확인할 수 있습니다.
사원번호 입력이 잘못되면 특정 구성원의 출퇴근기록이 다른 구성원의 flex 근태 기록에 영향을 미칠 수 있으니 주의하세요.
SightCube 프로그램을 사용 중이더라도 사원번호 입력은 반드시 Remote Access Manager (ADT캡스 엑세스 가드) 에서 진행해야 정상적인 사용자 매핑이 가능합니다.

4. 등록 활성화 및 연동 확인

모든 준비가 끝났습니다. 마지막으로 연동을 활성화한 뒤 테스트 기록을 통해 연결이 잘 되었는지 확인합니다.

4.1. 설정 적용을 위한 재시작

(Fig 4.1.a) Access Server Manager 프로그램을 통해 서버 정지 후 재시작
앞선 모든 설정을 적용하기 위해 재시작합니다.
먼저 지금까지 설정을 진행한 Remote Access Manager (ADT캡스 엑세스 가드) 프로그램을 종료하세요.
그 뒤 Access Server Manager 프로그램을 실행한 후 서버를 재시작합니다. (Fig 4.1.a)
1.
정지
2.
시작
마지막으로 Remote Access Manager (ADT캡스 엑세스 가드) 프로그램을 다시 실행합니다.

4.2. 근무 등록 옵션 활성화

(Fig 4.2.a) flex 제품 내 ‘설정 ‣ 연동 설정 ‣ ADT캡스 설정’ 화면
이제 제품 좌측 메뉴의 ‘설정 ‣ 연결 설정’ 에 들어와, ‘ADT캡스 연동’ 항목을 선택 후 ‘캡스로 근무 등록’ 옵션을 활성화하세요.

주의사항

Remote Access Manager (ADT캡스 엑세스 가드)가 설치된 기기는 항상 전원이 켜지고 인터넷에 연결된 상태를 유지하세요.
기록이 동기화되기까지 시간이 걸릴 수 있어요.
등록된 지 20시간이 지난 ADT캡스 출퇴근기록이 동기화될 땐 확정이 필요한 경우를 제외하곤 별도의 알림이 발생하지 않습니다.
연동에 따른 구성원 개인정보 처리에 대한 사내 고지 및 추가 동의 절차가 필요할 수 있습니다.

자주 묻는 질문

Q. 초기 연동에 어려움을 겪고 있습니다.

Q. 연동 설정에서 연동 상태는 “연동됨” 이라고 나오는데, ADT캡스에 기록을 남겨도 flex 출퇴근 기록으로 동기화되지 않아요.

Q. 사원번호를 잘못 입력했거나 빼먹어서 수정했는데, 새로 남기는 기록이 여전히 flex 출퇴근 기록으로 동기화되지 않아요.

Q. 사원번호 수정 전에 남긴 기록이 flex 출퇴근 기록으로 동기화되지 않아요.

Q. 잠깐 컴퓨터가 꺼진 동안 남은 출퇴근기록이 동기화가 안 된 것 같은데, 수동으로 동기화를 시키고 싶어요.