사용자 등록 및 변경 API(user.cud.document)

활용분야

1. 신입사원등록
2. 인사발령 (진급)
3. 인사발령 (부서이동)
4. 사원정보 변경 전화번호, 담당업무, 이메일 주소등이 변경되었을 때 반영하기 위함
5. 퇴사처리

개정이력

1. 2024년 02월 28일 기존 API 문서를 help 쪽으로 이동

사전 준비사항

1. 호출 원본 등록 호출하는 장소(서버)의 IP 및 URL중 호스트.도메인을 사전에 신고하셔야 합니다.
2. AuthKey 수령 보안키에 해당하는 AuthKey를 사전에 발급 받으셔야 합니다.

호출 시점

1. 신규 사원 등록 시
2. 상태(재직) 정보변경 시 (사용, 정지)
3. 부서 이동 시
4. 직위 변경 시
5. 직책 변경 시
6. 사용자 정보 삭제 시
7. 입사일자 변경 시
8. 핸드폰 변경 시
9. 이메일 주소 변경 시
10. 집주소 변경 시
11. 팩스번호 변경 시
12. 전화번호 (내선) 변경 시
13. 생년월일 변경 시

params 배열순서

1. AuthKey 발급받은 AuthKey 입력
2. 처리구분 varchar(1), A: 신규등록, E: 정보수정, 3:사용자정지, 1:사용자부활, D: 사용자삭제
3. 사용자아이디 varchar(17), 그룹웨어 사용자 아이디, 특수문제 불가
4. 사용자이름 nvarchar(50), 그룹웨어 사용자 이름, 특수문자 불가
5. ERP연동 사용자코드 varchar(40), 사번 같은, ERP에서 사용하는 사용자 Key
6. 성별 varchar(1), M: 남자, F: 여자
7. ERP 소속부서코드 varchar(40)
8. ERP 기본직위코드 varchar(40)
9. 입사일자 varchar(8), 입사년월일, 20230102 형식으로, 미 입력시 오늘 날짜 기본값
10. 핸드폰번호 varchar(50), 핸드폰번호, 없을 시 공백
11. 이메일주소 varchar(100), 없을 시 공백
12. 집주소 varchar(200), 거주지 주소, 없을 시 공백
13. 팩스번호 varchar(50), 없을 시 공백
14. 전화번호(내선) varchar(50), 없을 시 공백
15. ERP 기본직책코드 varchar(40)
16. 생일 varchar(40), 음/양력구분+생년월일, 구조: 음력양력구분(18:음력, 19:양력)+월(2자리)+일(2자리)+’-000‘+년(4자리) 예) 1970년 2월 4일 음력생일 -> “180204-0001970”
17. argCallbackResultUrl 요청한 데이타를 기준으로 결과값 URL을 받으실 주소입니다. 기본적으로, ERP시스템내의 API 서버의 도메인 주소는 미리 지정되므로, 그 이후의 URI를 입력하시면 됩니다.

결과

샘플

[ 그림. 샘플 화면 ]

sample 코드 (JavaScript)

1. 발급된 URL 정보를 호출하시면 됩니다.

const url = "https://wininet1.zioyou.com:443/users/user_cud?csrf=6bYxpWQdmCQMEtErEvHrLmH4Hm...";
val AuthKey = "xxxxxxxxxxxxxxxxxxxxxxxxx";
var formData = $('#form1').serialize();
$.ajax({
    url: url,
    headers: {
        'AuthKey': AuthKey //지오유에서 발급된 인증키
        ,'Content-Type':'application/x-www-form-urlencoded; charset=UTF-8'
    },
    method: 'POST',
    dataType: 'json',
    cache: false,
    data: formData,
    success: function(data){
        console.log(JSON.stringify(data));
    },
    error: function (request, status, error){
        console.log("code:"+request.status+"\n"+"message:"+request.responseText+"\n"+"error:"+error);
    }
});

Postman으로 테스트

[Tab]
Headers > AuthKey 기입
Body
 . x-www-form-urlencoded 체크
 . form 값들 기입

결과값 : 성공, zurl 나오는걸 볼 수가 있습니다.

sample 코드 (MS-SQL Stored Procedure)

declare @Object as int;
declare @ResponseText as varchar(8000);
declare @Body as varchar(8000)=''

exec sp_OACreate 'MSXML2.XMLHTTP',@Object OUT;
exec sp_OAMethod @Object, 'open', NULL, 'post', 'https://wininet1.zioyou.com:443/users/user_cud?csrf=6bYxpWQdmCQMEtErEvHrLmH4Hm...', 'false'

exec sp_OAMethod @Object, 'setRequestHeader', null, 'Content-Type', 'application/x-www-form-urlencoded'
exec sp_OAMethod @Object, 'send', null, @Body

exec sp_OAMethod @Object, 'responseText', @ResponseText OUTPUT
select @ResponseText

exec sp_OADestroy @Object

Online 데모

https://dev.zioyou.com/mashup/sample.user.cud.document.html