그룹웨어에 상신된 문서를 ERP에서 조회(View)하는 방법 (workflow.view.document )

전자결재 API 2024-02-29

신달수 0 댓글 612

API 소개

ERP 시스템과 그룹웨어 전자결재 시스템을 연동하는 요구는 상당히 많았습니다. 기존 1세대 때는, 데이타베이스(DB)를 공유하여, 서로 그곳에 쓰고, 갖어가고, 업데이트하는 구조였습니다. 이 기종간의 결합이니, 보안의 문제도 있고, 개발비고 드는 문제가 있었습니다. 그러나, 이제 ERP에서 직접 그룹웨어에 상신된 문서를 조회 하실 수 있습니다. 서로 DB를 열어야하는 부담감도 없습니다. API로 개발하여 공개하는 이유는, 어떤 ERP든 그룹웨어 측에서는 별도의 개발비가 발생하지 않습니다. 더불어, 연동되어지는 전자결재 양식이 많더라도 전혀 부담감이 없습니다.

1. workflow.view.document

1-1. 처리순서

Request Form 요청 4가지의 요청 파라메터를 전달하여, 목적지 http(s)://그룹웨어도메인/workflow.view.document 를 호출하십시요.

문서 열람 URL 수신 screen을 넘겨주시면, 결과를 결재화면으로 보실 수 있습니다. data로 넘겨주시면, 결과를 Json 데이타로 받아 보실 수 있습니다.

1-2. Form으로 넘겨줄 데이타

AuthKey 위에서 언급한 데로, 그룹웨어 서비스 제공자에게 받은 인증키(AuthKey)입니다. Request Header절에 넣어서 보내주셔야합니다.

argErpDocKey ERP에서 사용하는 사용자 계정입니다. 위에서 언급한데로 미리 그룹웨어 사용자계정과 연결(매핑)이 등록되어져야 합니다. ERP 계정을 통해, 그룹웨어 사용자를 찾는데 사용되어 집니다.

argGwDocKey 위 workflow.create.document에서 이벤트 콜백URL에서 넘겨드린 argCallBackErpEventUrl값을 잘 보관하셨다가, 이곳 열람시에 전달하셔야 합니다. 본 API로 생성하지 않은 문서는 열람하실 수 없습니다.

argViewGubun screen을 넘겨주시면, 결과를 결재화면으로 보실 수 있습니다. data로 넘겨주시면, 결과를 Json 데이타로 받아 보실 수 있습니다.

1-3. 결과 (argViewGubun=screen)

전자결재 문서를 화면으로 받으실 수 있습니다. 1회용 보안URL로 만들어 드립니다. (URL에 만료가 있다는 뜻으로, 일정시간이 경과되면, 자동으로 폐기되며 다시 요청하셔야 합니다.) 새창으로 웹브라우저를 통해 보실 수 있습니다.

[ 그림. 결과 화면을 Screen으로 본 샘플 ]

1-4. 결과 (argViewGubun=data)

전자결재문서를 데이타로 받으실 수 있습니다. 1회용 보안URL로 만들어 드립니다. JSON 문자열로 값을 전달해 드립니다. 파싱하여 ERP에서 활욯하실 수 있습니다. JSON 데이타 항목중에 코드에 해당하는 부분은 하단의 부록 부분에 설명해 놓았습니다. 참고하시기 바랍니다.

[ 그림. 결과 화면을 Data로 본 샘플 ]

부록 (data 항목설명)

docline -> signyn

N, 또는 빈값 결재자가 결재를 하지 않은 상태

A 결재자가 승인을 클릭한 상태

C 전결 버튼을 클릭한 상태

B 결재자가 반려를 클릭한 상태

H 결재자가 보류를 클릭한 상태

부록 (에러메세지)

0 The call to argCallErpResultUrl was successful.

18304 CONTENT_TYPE is invalid.

18305 REQUEST_METHOD is invaild.

18306 The blank value was passed.

15735 The authentication key is invalid or revoked keys.

17406 It calls only place allowed the predefined area.

19204 Calls can not be duplicated repeatedly allowed.

19205 This URL has been deprecated. If you keep calling, you will be blocked.

24158 ApiSvrAddr value must be registered in advance.

71284 You do not have access to the requested data. If you keep making the same request, you may be blocked.

2. Online Demo

https://dev.zioyou.com/mashup/sample.workflow.view.document.html

질문이 있으십니까?