네이버 클라우드 플랫폼의 상품 사용 방법을 보다 상세하게 제공하고, 다양한 API의 활용을 돕기 위해 [설명서]와 [API 참조서]를 구분하여 제공하고 있습니다.
조직 연동
조직 연동이란 고객사의 조직 정보 및 사원 정보를 WORKBOX의 조직 정보와 동기화시키는 작업을 의미합니다. 연동 가능한 조직 정보는 구성원의 속성을 이루는 직급, 직책, 부서 정보와 구성원 정보인 사원 정보입니다. 조직연동 작업이 완료되면 고객사 기업정보시스템의 조직 및 사원정보의 변동사항을 WORKBOX에서 추가적으로 변경하지 않아도 자동반영됩니다.
직책 연동
① WORKBOX 메뉴 Developers에 접속한 뒤 조직 연동 설정 항목 중 직책을 선택합니다.
② 설정선택의 디폴트 값은 OFF이며 클릭하여 ON으로 설정합니다.
- 직책 연동 'ON' 설정 시 WORKBOX의 '관리 > 구성원 > 기본 정보 설정'의 직책정보가 목록에 자동으로 표시됩니다.
- 직책 연동 'ON' 설정 시 WORKBOX의 기본 정보 설정 화면에서 직책은 조회만 가능하고, 추가/삭제/순서변경/저장/취소 버튼은 보이지 않습니다.
- 직책에 대한 연동이 필요하지 않을 시 설정선택을 'OFF' 상태로 변경합니다.
③ WORKBOX와 기업정보시스템의 직책을 연동합니다.
External Key 매핑을 합니다.
- 먼저 다운로드 버튼을 클릭하여 양식을 다운로드합니다. 엑셀 양식에 각 직책의 External Key를 입력한 후 파일첨부 버튼을 클릭하여 업로드합니다. 업로드 성공 시 화면에 key값이 설정됩니다.
현재 저장되어 있는 직책 정보를 기준으로 External Key를 등록해야하며 External Key 매핑 단계에서 기존 직책 정보를 추가, 삭제, 변경할 경우 연동 작업이 불가합니다.
직책 연동 API 가이드를 참조하여 직책정보를 연동합니다.
직급 연동
① WORKBOX 메뉴 Developers에 접속한 뒤 조직 연동 설정 항목 중 직급을 선택합니다.
② 설정선택의 디폴트 값은 OFF이며 클릭하여 ON으로 설정합니다.
- 직급 연동 'ON' 설정 시 WORKBOX의 '관리 > 구성원 > 기본 정보 설정'의 직급정보가 목록에 자동으로 표시됩니다.
- 직급 연동 'ON' 설정 시 WORKBOX의 기본 정보 설정 화면에서 직급은 조회만 가능하고, 추가/삭제/순서변경/저장/취소 버튼은 보이지 않습니다.
- 직급에 대한 연동이 필요하지 않을 시 설정선택을 'OFF' 상태로 변경합니다.
③ WORKBOX와 기업정보시스템의 직급을 연동합니다.
External Key 매핑을 합니다.
- 먼저 다운로드 버튼을 클릭하여 양식을 다운로드합니다. 엑셀 양식에 각 직급의 External Key를 입력한 후 파일첨부 버튼을 클릭하여 업로드합니다. 업로드 성공 시 화면에 key값이 설정됩니다.
직급 연동 API 가이드를 참조하여 직급정보를 연동합니다.
부서 연동
① WORKBOX 메뉴 Developers에 접속한 뒤 조직 연동 설정 항목 중 부서를 선택합니다.
② 설정선택의 디폴트 값은 OFF이며 클릭하여 ON으로 설정합니다.
- 부서 연동 'ON' 설정 시 WORKBOX 의 '서비스 환경 설정 > 구성원/그룹관리 > 조직도'의 부서 정보가 목록에 자동으로 표시됩니다.
- 부서 연동 'ON' 설정 시 WORKBOX 의 기본 정보 설정 화면에서 부서는 조회만 가능하고, 추가/삭제/순서변경/저장/취소 버튼은 보이지 않습니다.
- 부서 연동이 필요하지 않을 시 설정선택을 'OFF' 상태로 변경합니다.
③ WORKBOX와 기업정보시스템의 부서를 연동합니다.
External Key 매핑을 합니다.
- 먼저 다운로드 버튼을 클릭하여 양식을 다운로드합니다. 엑셀 양식에 각 부서의 External Key를 입력한 후 파일첨부 버튼을 클릭하여 업로드합니다. 업로드 성공 시 화면에 key값이 설정됩니다.
현재 저장되어 있는 부서 정보를 기준으로 External Key를 등록해야하며 External Key 매핑 단계에서 기존 부서 정보를 추가, 삭제, 변경할 경우 연동 작업이 불가합니다.
부서 연동 API 가이드를 참조하여 부서정보를 연동합니다.
사원 연동
① WORKBOX 메뉴 Developers에 접속한 뒤 조직 연동 설정 항목 중 사원을 선택합니다.
② 설정선택의 디폴트 값은 OFF이며 클릭하여 ON으로 설정합니다.
- 사원 연동 'ON' 설정 시 WORKBOX의 '서비스 환경 설정> 구성원/그룹관리 > 구성원관리'에 등록되어 있는 사원명과 업무메일이 자동으로 표시됩니다.
- 사원 연동 'ON' 설정 시 WORKBOX의 사원 관리 화면에서 사원은 조회만 가능합니다.
- 사원 연동 'ON' 설정 시 WORKBOX의 사원 정보에서 사원정보 조회만 가능하고, 정보 수정이나 삭제는 사용할 수 없습니다. 사원정보 수정이나 삭제는 고객사의 기업정보시스템에서 진행합니다.
- 사원 연동이 필요하지 않을 시 설정선택을 'OFF' 상태로 변경합니다. 단 OFF로 변경 시, 추가정보 연동에 영향이 있을 수 있습니다.
③ WORKBOX와 기업정보시스템의 사원정보를 연동합니다.
External Key 매핑을 합니다.
- 먼저 다운로드 버튼을 클릭하여 양식을 다운로드합니다. 엑셀 양식에 각 사원의 External Key를 입력한 후 파일첨부 버튼을 클릭하여 업로드합니다. 업로드 성공 시 화면에 key값이 설정됩니다.
현재 저장되어 있는 사원 정보를 기준으로 External Key를 등록해야하며 External Key 매핑 단계에서 기존 사원 정보를 추가, 삭제, 변경할 경우 연동 작업이 불가합니다.
사원 연동 API 가이드를 참조하여 사원정보를 연동합니다.
조직연동 배치 흐름
두 시스템 간의 조직정보가 연동된 후, 각 항목별 배치 작업을 통해 동기화를 진행합니다. 조직 연동은 직급-직책-부서-사원 순으로 일(Day) 단위 배치를 실행할 것을 권장합니다. 각 단계에서 실패 시 롤백 프로세스는 고객사의 사내 정책에 맞게 적용하도록 합니다. 단, 한 단계 안에서 일부가 실패했을 때(조직 중 일부가 실패)는 계속 진행하고, 한 단계 전체가 실패하면(조직 전체가 실패) 배치를 중단할 것을 권장합니다.
