구성원 추가 API 문의

Question

작성하신 내용은 누구나 볼 수 있습니다.

계정 이름, 도메인 이름, API ID, ConsumerKey 등의 비공개 정보는 기입하지마세요.

안녕하세요.

아래 답변주셨던 대로 해당건 해결하였습니다.

빠른답변 감사합니다.

이번에는 조직연동 관련하여 문의 드립니다.

현재 구성원 추가 API 관련 작업을 진행중인데요,

API 필수 파라매터를 보면 externalKey 값들이 필수로 입력되어야 합니다.

https://apis.worksmobile.com/r/{API ID}/organization/v2/domains/{domainId}/users/{externalKey}

1. 신규 구성원 추가 API 실행시에 externalKey 값이 필수값인데 이 값의 설명을 보면 "원직의 구성원 외부 키" 라고 되어있습니다.

신규구성원의 경우 externalKey 값이 기존에 생성되어있지 않을 것이며, 신규로 추가하여야 하는것으로 생각되는데요.

존재 할 수 없는 externalKey 값이 필수값이라는 점이 이해가 가지 않습니다. 이 값이 필수값이 맞는지요?

2. 현재 저희 회사의 조직, 구성원, 그룹, 고용형태, 직급, 직책의 모든 External Key Mapping 이 입력되어있지 않은 상태입니다.

이 경우 조직연동 API를 사용 할 수 없는 것인가요?

위의 문의 사항에 대하여 답변 부탁드립니다.

감사합니다.

NAVER WORKS · Answer

안녕하세요. LINE WORKS 입니다.

문의주신 조직연동 관련하여 답변드립니다.

1. 신규 구성원 추가 API 실행시에 externalKey 값이 필수값인데 이 값의 설명을 보면 "원직의 구성원 외부 키" 라고 되어있습니다.
신규구성원의 경우 externalKey 값이 기존에 생성되어있지 않을 것이며, 신규로 추가하여야 하는것으로 생각되는데요.
존재 할 수 없는 externalKey 값이 필수값이라는 점이 이해가 가지 않습니다. 이 값이 필수값이 맞는지요?

→ externalKey 값은 '고객사의 인사시스템 조직' <> 'LINE WORKS 조직'의 무결성을 보장하는 값입니다.

예를 들어 고객사의 인사시스템에서 각 조직들을 구분하는 고유의 키(예:DB의 PK) 값이라고 생각하시면됩니다.
    구성원의 경우 대체적으로 직원 중에 동명이인을 구별할 수 있는 사번을 external key 로 사용합니다.
   
    따라서, 조직연동 API를 사용하기 위해서는 ext

홍길동_166 · Answer

빠른 답변 감사합니다.
External Key값을 매핑하여 사용한다는 점은 확인 했습니다.
다만 1번의 경우, 
신규 구성원에 대한  데이터 자체가 라인웍스 데이터상에 존재하지 않아 
External Key값을 매핑하는 선 작업을 시행할 수 없습니다.
그렇다면 신규 구성원 추가 API기능은 사용 할 수 없는건가요?

NAVER WORKS · Answer

안녕하세요. LINE WORKS 입니다.

구성원 추가 API를 통해 구성원을 추가하고 싶은 경우 아래와 같은 방법으로 진행해주시면 됩니다.

1. [Developer Console > 조직연동]화면에서 조직연동 사용설정을 'on'으로 적용
2. 조직/구성원을 'on' 설정
3. 구성원 추가 API를 통해 신규 구성원정보와 맵핑할 {externalKey}를 전달

단, 기존 구성원은 External Key 값이 Mapping 되어 있지 않기 때문에
이전 안내드린 파일첨부를 통해 Mapping 작업을 진행해주시면 조회, 수정, 삭제 등 API 로 요청할 수 있습니다.

감사합니다.

신고사유

공유하기

NAVER WORKS

Developers

구성원 추가 API 문의

댓글3