📌 온나라 시스템 인사 DB 연동 작업 기록

📝 개요

고객사 중 한 곳이 내부적으로 사용하는 온나라 시스템의 인사 데이터를 우리 시스템과 연동해달라는 요청을 받았다.

이 고객사는 CUBRID 데이터베이스를 사용하고 있었고, 우리는 해당 DB에 직접 접근하여 부서 및 사용자 정보를 가져오는 기능을 구현해야 했다.

기존 고객사들은 대부분 MySQL, MSSQL 등을 사용했기 때문에, CUBRID 기반 연동은 처음이었고 새로운 경험이었다.

이번 작업은 하이브리드 앱의 조직도와 사용자 정보 관리 기능과도 연결되어 있었기 때문에, 데이터 구조 파악과 쿼리 작성, 연동 흐름을 모두 고려해야 했다.

⚙️ 연동 구조 및 흐름 설명

1. XML 기반 설정 구성

고객사별 DB 접속 정보, 쿼리, 전처리 규칙은 XML 설정 파일에 정의되어 있다.

CUBRID에 맞춘 설정 예시는 다음과 같다.

<hrissync-database>
  <username>onnara_view</username>
  <password>onnara_view</password>
  <conn-url><![CDATA[jdbc:cubrid:xxx.xxx.xxx.xxx:33000:onnara_db]]></conn-url>
  <driver>cubrid.jdbc.driver.CUBRIDDriver</driver>
  <default-password>1234</default-password>

부서 및 사용자 정보 추출 쿼리는 아래와 같이 작성된다:

<select-dept><![CDATA[
  SELECT ORGID AS CODE, ... FROM COM_ORGANIZATIONINFO ...
]]></select-dept>

<select-user><![CDATA[
  SELECT USERID AS USER_ID, ... FROM COM_USERINFO_DETAIL ...
]]></select-user>

전화번호 등 숫자 필드 정제 규칙도 <convert> 태그로 정의되어 있다.

2. 서버 연동 전체 흐름

✅ 1. 수동 실행 요청 (API 호출)