안녕하세요.
사용자의 눈높이에 맞춘 이메일보안 지킴이 지란지니입니다.
MailScreen은 사내 인사 DB(데이터베이스)와 연동하여 임직원 정보를 주기적으로 동기화합니다.
본 가이드는 연동을 위해 고객사 측에서 준비해야 하는 View(뷰, 데이터베이스 조회용 가상 테이블) 구성 규격을 안내합니다.
※ 고객사마다 인사 DB 구조와 운영 환경이 다르기 때문에, 실제 연동 방식은 본 가이드를 참고하되 반드시 기술지원 엔지니어와의 사전 협의를 통해 확정하시기 바랍니다. 연동 유형 선택, View 구성, 동기화 주기 설정 등 세부 사항은 협의 후 진행합니다.
1. 개요
MailScreen과 고객사 인사 시스템을 연동하기 위해서는 고객사 그룹웨어(또는 인사 DB 시스템)에서 아래 규격에 맞는 View를 생성하고 MailScreen에 제공하여야 합니다.
| 항목 | 내용 |
|---|---|
| 연동 방식 | 고객사 인사 DB → View 생성 → MailScreen 동기화 |
| 동기화 대상 | 발신자, 결재자, 결재 위임자, 검토자 등 임직원 정보 |
| View 명 | 기본 명칭 제공, 고객사 환경에 맞게 변경 가능 |
| 연동 유형 | 고객사 인사 DB 구조에 따라 3가지 유형 중 선택 |
2. 연동 유형 선택
고객사의 인사 DB 구조에 따라 아래 3가지 연동 유형 중 하나를 선택합니다. 유형 선택은 기술지원 엔지니어와 협의하여 결정합니다.
| 유형 | 적합한 환경 | 생성 View 수 |
|---|---|---|
| 통합형 | 임직원 1명당 메일·부서·결재자·검토자가 각 1개인 단순 구조 | 1개 (MSCREEN_HR) |
| 임직원-부서 분리형 | 임직원 1명이 여러 부서에 소속되거나 부서를 코드로 관리하는 구조 | 3개 (MSCREEN_HR, MSCREEN_DEPT, MSCREEN_USR_DEPT) |
| 완전 분리형 | 임직원 1명이 여러 부서·메일·결재자·검토자를 사용하거나 복수 결재가 필요한 구조 | 6개 (MSCREEN_HR, MSCREEN_DEPT, MSCREEN_USR_DEPT, MSCREEN_EMAIL, MSCREEN_MGR, MSCREEN_REVIEWER) |
3. 유형별 View 구성 규격
3-1. 통합형
임직원 개인의 정보를 하나의 레코드로 통합하여 제공하는 방식입니다.
적용 조건
- 임직원 1명당 메일 주소, 부서, 결재자, 검토자가 각각 1개인 경우
- 부서 경로는 가장 상위 조직부터
^문자로 구분하여 입력합니다. (예:총무부^지원팀)
데이터 예시
EMP_NO (사번) | NAME (이름) | POS (직급) | EMAIL (메일) | DEPT_PATH (부서) | MANAGER (결재자) |
|---|---|---|---|---|---|
| 2000 | 홍길동 | 사원 | hong@example.com | 총무부^지원팀 | 1000 |
| 1000 | 이순신 | 부장 | shin@example.com | 총무부 |
View 스키마: MSCREEN_HR
| 필드명 | 데이터 형식 | 기본값 | 필수 여부 | 설명 |
|---|---|---|---|---|
EMP_NO | VARCHAR(32) | 필수 | 사번 (예: A1234) | |
EMAIL | VARCHAR(50) | 필수 | 메일 주소 (예: user@example.com) | |
NAME | NVARCHAR(32) | 이름 (예: 홍길동) | ||
POS | NVARCHAR(20) | 직급명 (예: 부장) | ||
MANAGER | VARCHAR(32) | 결재자 사번 | ||
REVIEWER | VARCHAR(32) | 검토자 사번 | ||
USE_TRUSTEE | CHAR(1) | N | Y 이면 결재 위임자에게 결재 위임 | |
TRUSTEE | VARCHAR(32) | 결재 위임자 사번 | ||
TS_DATE | DATE | 0000-00-00 | 결재 위임 시작일 | |
TE_DATE | DATE | 0000-00-00 | 결재 위임 종료일 | |
USE_SMS | CHAR(1) | Y | Y 이면 결재 요청을 휴대폰 문자로 발송 (한국만 유효) | |
MOBILE | VARCHAR(20) | 휴대폰 번호 (예: 010-1234-1234) | ||
LANG | CHAR(2) | ko | 사용 언어 (ko 국문 / en 영문 / ja 일문) | |
DEPT_PATH | NVARCHAR(512) | ^ 문자로 구분된 소속 부서 경로 (예: 회사^총무부^지원팀) | ||
BYPASS | CHAR(1) | N | Y 이면 모든 정책 적용에서 예외 처리 |
※
USE_TRUSTEE,TRUSTEE,TS_DATE,TE_DATE,REVIEWER,USE_SMS,MOBILE,LANG,DEPT_PATH,BYPASS필드에 값이 없는 경우, MailScreen에 기존 저장된 정보가 그대로 유지됩니다.
3-2. 임직원-부서 분리형
임직원 1명이 여러 부서에 소속되거나 부서를 별도 코드로 관리하는 경우 사용합니다.
적용 조건
- 임직원 1명이 최대 5개 부서에 소속 가능
- 메일 주소, 결재자, 검토자는 1명당 각 1개만 지정 가능
- 부서 정보를 별도 코드로 관리하는 경우
데이터 예시
MSCREEN_HR (임직원 정보)
| 사번 | 이름 | 직급 | 메일 | 결재자 |
|---|---|---|---|---|
| 2000 | 홍길동 | 사원 | hong@example.com | 1000 |
| 1000 | 이순신 | 부장 | shin@example.com |
MSCREEN_USR_DEPT (임직원-부서 연결)
| 사번 | 부서코드 |
|---|---|
| 2000 | D002 |
| 1000 | D001 |
| 1000 | D002 |
MSCREEN_DEPT (부서 정보)
| 부서코드 | 상위부서코드 | 부서명 |
|---|---|---|
| D001 | 총무팀 | |
| D002 | D001 | 지원팀 |
View 스키마: MSCREEN_HR
통합형의 MSCREEN_HR 스키마와 동일합니다. 단, DEPT_PATH 필드 대신 MSCREEN_USR_DEPT, MSCREEN_DEPT View를 통해 부서 정보를 연결합니다.
View 스키마: MSCREEN_DEPT
| 필드명 | 데이터 형식 | 필수 여부 | 설명 |
|---|---|---|---|
DEPT_CODE | VARCHAR(38) | 필수 | 부서코드 (예: D1234) |
PDEPT_CODE | VARCHAR(38) | 필수 | 상위 부서 코드 |
NAME | NVARCHAR(64) | 필수 | 부서명 (예: 총무부) |
※ 부서 코드는 영문, 숫자,
_,-문자로만 구성하여야 합니다.
View 스키마: MSCREEN_USR_DEPT
| 필드명 | 데이터 형식 | 필수 여부 | 설명 |
|---|---|---|---|
EMP_NO | VARCHAR(38) | 필수 | 사번 (예: A1234) |
DEPT | VARCHAR(38) | 필수 | 부서코드 (예: D1234) |
※ 임직원 1명당 최대 5개의 부서를 지정할 수 있습니다.
3-3. 완전 분리형
임직원 1명이 여러 부서·메일·결재자·검토자를 사용하거나 복수 결재가 필요한 경우 사용합니다.
적용 조건
- 임직원 1명이 여러 부서에 소속된 경우
- 임직원 1명이 여러 메일 주소를 사용하는 경우
- 결재 시 여러 명의 결재자·검토자가 필요한 경우
- 메일 주소, 부서, 결재자, 검토자 각각 최대 5개까지 지정 가능 (초과 데이터는 무시)
데이터 예시
| 사번 | 이름 | 직급 | 메일 | 부서 | 결재자 | 검토자 |
|---|---|---|---|---|---|---|
| 2000 | 홍길동 | 사원 | hong@example.com | 지원팀 | 이순신 | 강감찬 |
| 1500 | 강감찬 | 과장 | chan@example.com | 지원팀 | 이순신 | |
| 1000 | 이순신 | 부장 | shin@example.com | 총무팀 |
View 스키마: MSCREEN_HR
| 필드명 | 데이터 형식 | 기본값 | 필수 여부 | 설명 |
|---|---|---|---|---|
EMP_NO | VARCHAR(32) | 필수 | 사번 (예: A1234) | |
NAME | NVARCHAR(32) | 이름 (예: 홍길동) | ||
POS | NVARCHAR(20) | 직급명 (예: 부장) | ||
USE_TRUSTEE | CHAR(1) | N | Y 이면 결재 위임자에게 결재 위임 | |
TRUSTEE | VARCHAR(32) | 결재 위임자 사번 | ||
TS_DATE | DATE | 0000-00-00 | 결재 위임 시작일 | |
TE_DATE | DATE | 0000-00-00 | 결재 위임 종료일 | |
USE_SMS | CHAR(1) | Y | Y 이면 결재 요청을 휴대폰 문자로 발송 (한국만 유효) | |
MOBILE | VARCHAR(20) | 휴대폰 번호 (예: 010-1234-1234) | ||
LANG | CHAR(2) | ko | 사용 언어 (ko / en / ja) | |
BYPASS | CHAR(1) | N | Y 이면 모든 정책 적용에서 예외 처리 |
View 스키마: MSCREEN_DEPT
임직원-부서 분리형의 MSCREEN_DEPT 스키마와 동일합니다.
View 스키마: MSCREEN_USR_DEPT
임직원-부서 분리형의 MSCREEN_USR_DEPT 스키마와 동일합니다.
View 스키마: MSCREEN_EMAIL
| 필드명 | 데이터 형식 | 필수 여부 | 설명 |
|---|---|---|---|
EMP_NO | VARCHAR(32) | 필수 | 사번 (예: A1234) |
EMAIL | VARCHAR(50) | 필수 | 메일 주소 (예: user@example.com) |
※ 임직원 1명당 최대 5개의 메일 주소를 지정할 수 있습니다.
View 스키마: MSCREEN_MGR
| 필드명 | 데이터 형식 | 필수 여부 | 설명 |
|---|---|---|---|
EMP_NO | VARCHAR(32) | 필수 | 사번 (예: A1234) |
MANAGER | VARCHAR(32) | 필수 | 결재자(직책자) 사번 |
※ 임직원 1명당 최대 5명의 결재자를 지정할 수 있습니다.
View 스키마: MSCREEN_REVIEWER
| 필드명 | 데이터 형식 | 필수 여부 | 설명 |
|---|---|---|---|
EMP_NO | VARCHAR(32) | 필수 | 사번 (예: A1234) |
REVIEWER | VARCHAR(32) | 필수 | 검토자 사번 |
※ 임직원 1명당 최대 5명의 검토자를 지정할 수 있습니다.
4. 주요 필드 상세 설명
| 필드명 | 상세 설명 |
|---|---|
EMAIL | 값이 없으면 해당 임직원은 인사정보에 등록되지 않습니다. |
MANAGER | 해당 임직원이 발송한 메일이 결재 정책에 적용되면 지정된 결재자에게 결재 요청 메일을 발송합니다. 결재자도 결재자 지정이 가능합니다. |
REVIEWER | 해당 임직원이 발송한 메일이 정책 알림 대상에 해당하면 지정된 검토자에게 숨은 참조(BCC) 메일을 발송합니다. |
TRUSTEE | 결재자 부재 시 결재 위임자에게 결재 요청을 대신 발송합니다. USE_TRUSTEE가 Y인 경우에만 동작하며, 결재자와 위임자 중 한 명이 결재할 수 있습니다. |
TS_DATE / TE_DATE | 결재 위임 사용 시 위임 기간(시작일~종료일)은 필수 값입니다. 위임 기간 내에만 위임 기능이 동작합니다. 형식: 0000-00-00 |
DEPT_PATH | 소속 부서를 가장 상위 조직부터 ^ 문자로 구분하여 입력합니다. (예: 회사^총무부^지원팀) |
BYPASS | Y로 설정하면 해당 임직원에게는 모든 메일 정책이 적용되지 않습니다. |
5. 연동 유형 선택 기준 요약
| 확인 항목 | 해당 유형 |
|---|---|
| 임직원 1명이 1개의 부서, 1개의 메일, 1명의 결재자를 사용하는 경우 | 통합형 |
| 임직원 1명이 여러 부서에 소속되거나, 부서를 코드로 관리하는 경우 | 임직원-부서 분리형 |
| 임직원 1명이 여러 부서·메일·결재자·검토자를 사용하거나, 복수 결재가 필요한 경우 | 완전 분리형 |
6. 연동 전 확인 사항
본 가이드는 MailScreen 인사 연동의 표준 규격을 안내하는 참고 문서입니다. 실제 연동 작업은 반드시 아래 절차에 따라 진행하시기 바랍니다.
- 고객사 인사 DB 구조 및 운영 환경을 기술지원 엔지니어에게 공유합니다.
- 엔지니어와 협의하여 적합한 연동 유형(통합형 / 임직원-부서 분리형 / 완전 분리형)을 확정합니다.
- 확정된 유형에 맞게 고객사 측에서 View를 생성합니다.
- MailScreen 서버에서 연동 설정 및 동기화 테스트를 진행합니다.
※ 고객사마다 인사 DB 구조, 그룹웨어 종류, 부서 관리 방식이 상이하므로, 본 문서의 규격을 임의로 적용하지 마시고 기술지원 엔지니어와의 협의 후 진행하시기 바랍니다.
추가 문의 사항이 있으시면 기술지원팀(1600-8300)으로 언제든지 연락해 주시기 바랍니다.