K-System 연동

영림원소프트랩의 K-System과 연동하여 ERP 내부 데이터를 연동해서 Flextudio 에서 개발 할 수 있습니다. K-System연동은 고객별로 개별 설정을 하게 되며, 같은 앱을 사용하는 고객 들이더라도 각 고객별로 설정(연동)된 K-System으로 동작하게 됩니다.

K-System 연동은 Business 플랜 이상에서 사용하실 수 있습니다.

[도입문의]

1~ 6번까지 내용은 영림원소프트랩의 사용자를 동기화 하기 위한 사전 절차와도 동일합니다.

연동 설정하기

1. Flextudio IP주소 허용하기

K-System을 방화벽 안에서 운영중이라면 특정 IP 주소에 대한 방화벽 해제가 필수적입니다. 원활한 DB 호출을 보장하기 위해 다음 IP 주소에 대한 방화벽 해제 조치가 필요합니다.

3.38.20.130 (Flextudio 서비스 중개서버)

2. OpenAPI 설치 확인하기

OepnAPI가 설치되어 있는지 확인합니다. OpenAPI에 대한 호출정보를 알고 있어야 합니다. (모를 경우 설치경로 확인), 일반적으로 K-System ACE의 경우에는 ERP 사용 URL과 같은 경우가 많습니다.

K-System ACE 이상을 사용중이라면 K-System OpenAPI가 함께 설치가 됩니다. 그 이하의 버전인 경우에는 별도로 ERP 구축사에 설치 요청을 하여서 설치가 된 후에 이용이 가능합니다.

3. ERP 연동정보 입력

ERP의 [사용자정의코드등록(전체)] 화면에서 고객사에 해당하는 정보를 입력합니다.

ERP 화면 예시

4. ERP 연동 화면 패치

신규설치 대상 고객사 ERP에 [모바일설정] 화면 패치가 적용 되었는지 확인합니다. Flextudio를 사용하기 위한 사용자정보 동기화와 설정 페이지 접속에 사용합니다.

'사용' 버튼을 통해 3번에서 입력한 정보가 Flextudio로 연동됩니다.

'사용자 동기화'시 Flextudio로 데이터 연동에 기준이 되는 ERP 데이터는 'EmpID'로 Flextudio에서는 'fBaseUserNo'로 활용합니다. 또한 ERP 내 CellPhone과 Email 데이터는 동기화 요건에 필수는 아니지만 앱 사용시에 필요한 항목이므로 둘 중 하나의 데이터는 반드시 ERP내에 존재해야 합니다.

5. OpenAPI 사용을 위한 ERP 설정

플렉스튜디오에서 OpenAPI를 사용하기 위해서는 ERP 내에서 특정 정보가 입력되어야 합니다. 영림원소프트랩 ERP의 [Ksystem API 등록] 화면에서 외부시스템 인증정보와 SP 공개설정을 확인해주세요.

자세한 설정 내용은 ERP 구축팀 혹은 플렉스튜디오로 문의해 주세요.

외부시스템 인증정보

• 인증ID: Flextudio, Flextudio_SyncUser

• 인증키: 별도 문의

SP 공개설정

• 호출ID: FlextudioBis, FlextudioOper

• 스크립트ID: 별도 문의

• 스크립트명: 별도 문의

6. K-System 사용

K-System은 고객별로 하나의 시스템만 연동할 수 있습니다. [고객관리]-[회사정보] 메뉴로 이동하여 사용할 System에 K-System을 선택후 저장 합니다.

사용자 연동에 대한 설명은 [회사정보] 에서 확인 가능합니다.

[고객관리]-[시스템 정보] 로 이동하여서 아래 내용을 채우고 저장합니다.

시스템 설정 값	설명	경로 위치
Oper dsn	공통(운영) DSN 명	ERP
Bis dsn	업무 DSN 명	ERP
CompanySeq	법인의 시퀀스 값	ERP
OpenAPI Url	Flextudio에서 데이터 요청을 하기 위한 ERP 어플리케이션 서버에 설치된 K-SystemOpenAPI URL 경로 (ACE는 기본 경로가 ERP 접속 경로와 같습니다.)	ERP 어플리케이션 서버
OpenAPI port (없을수도 있음)	위와 같은 목적지의 Port 번호 (ACE는 기본 경로가 ERP 접속 경로와 같습니다.)	ERP 어플리케이션 서버
FileServerDir	파일서버 경로(사용을 위해선 별도 구축 필요)	ERP 파일 서버
Custom Sync SP	사용자 동기화에 사용하는 커스텀 SP	ERP 데이터베이스
Custom Sync UserNoKey	사용자 기준 키인 fBaseUserNo로 사용할 컬럼명 (없을경우 기본값은 EmpId)
K-Smart file Url	이미지 컨트롤 사용시 필수 입력 값

Custom Sync SP에는 매개변수를 전달할 수 없습니다.

리턴되는 테이블은 아래의 컬럼 이름으로 구성되어야 합니다.

• EmpId (필수): 사용자를 구분하는 기준 키(Custom Sync UserNoKey로 쓰임)

• EmpName(필수): 사용자 이름

• Phone(필수): 사용자 휴대폰 번호

• Email(필수): 사용자 이메일 주소

• EntDate: 입사일

• RetireDate: 퇴사일

• DeptName: 부서이름

• customKey1 ~ customKey6: 추가 포함할 정보

customKey1~customKey6 의 컬럼이름으로 원하는 정보를 포함할 수 있으며 이 정보는 [회사 정보] 메뉴의 [사용자 관리항목 추가]에서 각 순서대로 이름을 매핑할 수 있습니다.

6. 호출하기

등록한 K-System은 아래와 같이 Service에서 ksystem 시스템으로 등록하여서 사용이 가능합니다.