This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
Zioyou OpenAPI UI Class
- 전자결재 양식 연동 API -
문서정보(Document Information)
⦁ 문서생성
⦁ 작성자 : 지오유 기업부설 연구소 신달수소장
⦁ 작성일자 : 2013년 03월 31일
⦁ 문서번호 : ZioYou-WorkFlowSyncForm-20130331001
⦁ 문서최종개정이력
⦁ 최종개정자 : 지오유 기업부설 연구소 박성규선임연구원
⦁ 최종개정일 : 2015년 05월 18일
⦁ 최종문서번호 : ZioYou-WorkFlowSyncForm-20150518003
1
목차
⦁ 문서개정이력
⦁ 기본연동 규격
⦁ 정책 및 규정
⦁ 전자결재 양식 연동 API
⦁ 테스트 요청서 Sample
2
문서개정이력 (최신순)
[ ZioYou-WorkFlowSyncForm-20150518003 ]
⦁ 문서번호 : ZioYou-WorkFlowSyncForm-20150518003
⦁ 개정일자 : 2015-05-18
⦁ 주요개정내용
⦁ ActProc() 함수의 리턴값 다변화
⦁ 기존에는, True/False만 반환했지만, 이제는 문서내용에 따라 변경하고자 하는
“결재라인번호”를 함께 반환할 수 있는 구조로 개선
⦁ 작업자는 결재문서의 내용에 따라 “결재라인번호”를 변경하는 것이 가능하게
됨
⦁ “결재라인번호”를 반환할 시, 현재 상신하는 문서의 결재라인이 반환된 “결재라
인번호”로 자동으로 변경되는 기능을 수행함.
⦁ “결재라인번호”를 반환 시, return true에 해당하는 것으로 이해하고, 결재상신
을 가능하도록 처리함
⦁ 개정자 : 지오유 박성규선임연구원
⦁ 최종감수자 : 지오유 신달수연구소장
[ ZioYou-WorkFlowSyncForm-20140809001 ]
⦁ 문서번호 : ZioYou-WorkFlowSyncForm-20140809001
⦁ 개정일자 : 2014-08-09
⦁ 주요개정내용
⦁ “연동C방식”에 대한 sample source code 기술
⦁ 위, 방식에 대한 화면 세로높이(Height) 값에 대한 자동 증감기능 버그수정으로
인한 호출 방법 및 함수명 업데이트
⦁ 개정자 : 지오유 박성규선임연구원
⦁ 최종감수자 : 지오유 신달수연구소장
3
기본연동 규격
⦁ 연동포트
보안 및 범용성의 이유로 80포트만을 사용하여 연동 가능합니다.
더불어, 클라우드 서비스 이용시 방화벽 설정의 문제로 그 외의 다른 포트는 사용할 수
없습니다.
⦁ 전송방법
클라이언트는 XHR(XML Http Request) 및 http를 GET 방식 및 POST 방식을 통해 호출
합니다.
⦁ 호출자는 Http ASync 통신을 통해 결과값을 확인할 수 있습니다.
⦁ 성공 : String “success”
⦁ 실패 : String “failed:실패사유”
⦁ Http는 기본적으로 Async 통신을 하기 때문에, 성공이벤트를 수신을 통해 결과값을
받아야 합니다.
⦁ 호출자의 서버 페이지는 사전 등록되어야 합니다.
⦁ 본 OpenAPI는 “HTTP_REFFERER” 를 체크합니다. (즉, 미리 지정되거나 등록되지 않는 페
이지는 차단합니다. 어떠한 결과값도 받을 수 없습니다.)
⦁ 그러므로, 호출하는 서버 페이지의 URL은 반드시, 사전 등록되어져 있어야 합니다.
⦁ 지정한, 페이지에서의 호출만 받아들입니다.
⦁ 정확한 연동결과를 위해 외부시스템과 그룹웨어간의 “코드 및 데이터 매칭” 작업을 하는
경우가 발생합니다.
⦁ 본 API에서 제공하는 Parameter(파라메터) 전달 규칙들이 있습니다. (하단 페이지
참조)
⦁ 이종 시스템간 연동이기 때문에 그룹웨어에 사용자의 부주의로 인한 중복코드 입력
시 원하지 않은 데이터의 훼손이 일어날 수 있음을 주의하시기 바랍니다.
⦁ 부주의로 인한 사용자 데이터의 훼손은 지오유에서 일체 책임을 지지 않습니다.
4
⦁
정책 및 규정지오유 그룹웨어 외부연동 API 사용에 대한 정책 및 규정입니다.
⦁ 외부연동의 이용목적
⦁ 외부연동 API의 개발목적은 이종 시스템간의 업무를 자동적/능동적으로 Sync 하는
것으로 타시스템과 그룹웨어와의 전자결재 양식 연동에 있습니다.
⦁ 외부연동 API는 지오유의 유료상품이며 계약하지 않고 API를 이용하여 어플리케이
션을 개발할 경우 민/형사상의 책임을 물을 수 있습니다.
※ 외부연동의 견적 및 문의는 고객센터 070-7094-6400번으로 연락주시기 바랍니다.
⦁ 외부연동의 사용방법
⦁ 전자결재 양식연동 API는 외부시스템간의 약속을 토대로, 전자결재 양식을 연동하
는 방식입니다.
⦁ 전자결재 양식연동으로 유입되는 정보가 없는 경우 상황에 따라 아무동작없이 끝나
거나, 빈페이지를 표시될 수 있습니다.
에러코드는 Sync통신으로 에러의 내용이 반환됩니다.
⦁ 단. 외부시스템과 전자결재 양식연동을 사용하기에 앞서 그룹웨어와 외부시스템간
에 사용자 계정 정보를 정확히 유입시켜야 합니다.
관리자 및 외부연동 시스템코드의 무분별한 유입으로 인한 데이터의 훼손은 지오유
에서 일체 책임을 지지 않습니다.
⦁ 외부연동 시 사용자데이터 보호 대책
지오유에서는 사용자의 데이터를 취급함에 있어 변조 또는 훼손되지 않도록 안전성 확
보를 위하여 다음과 같은 기술적/관리적 대책을 강구하고 있습니다.
⦁ 도메인 확인
그룹웨어에 등록된 도메인이 없을 경우(=계약정보) 무조건 에러코드를 리턴합니다.
⦁ 접속지(호출) 클라이언트의 IP 등록
원격지(호출)서버의 IP를 관리자가 등록 지정, IP와 도메인이 미리 등록되지 않을경
우 에러코드를 리턴 할 수 있습니다.
5
전자결재 양식연동 API
⦁ 3가지 연동 방식
⦁ “A” 방식
[ 그림 : “A” 방식에 대한 처리 흐름도 ]
⦁ “A” 방식에 대한 설명
⦁ 기본적으로 전자결재 호출이, 연동하고자 하는 외부시스템에서 발생합니다.
⦁ 외부시스템(이하, ERP)에서 “전자결재 상신하겠습니까?” 라는 사용자 Interface
가 존재할 것으로 가정합니다.
⦁ ERP 시스템에서 호출이 될 때, 전달할 값들을, 넘겨줄 수도 있고, 그냥 키 값만
넘겨줄 수도 있습니다.
⦁ 위에서 받은, 데이터를 “전자결재시스템”에서 “임시보관함”에 넣어 놓습니다.
⦁ 사용자는, “임시보관함”에 있는 데이터를 근거로, 결재Process를 진행합니다.
⦁ “상신”, “승인”, “반려”일 때, ERP시스템에 특정신호를 호출합니다. (“양식관리”안