구성원 추가 API 문의

홍길동_166

2019.07.18읽음 3711

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

계정 이름, 도메인 이름, 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를 사용 할 수 없는 것인가요?
위의 문의 사항에 대하여 답변 부탁드립니다.
감사합니다. 

댓글3

  • 업데이트 된 답글입니다.

    NAVER WORKS 공식계정

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

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

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

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

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

    2. 현재 저희 회사의 조직, 구성원, 그룹, 고용형태, 직급, 직책의 모든 External Key Mapping 이 입력되어있지 않은 상태입니다.
    이 경우 조직연동 API를 사용 할 수 없는 것인가요?

    → 조직연동 API를 사용하기 전 Admin 페이지에서 추가한 조직정보는 말씀하신대로 External Key가 없는 상태입니다.
       
       [Developer Console > 조직연동] 페이지에 접속하시면
       하단의 현재 고객님의 조직정보에 대한 External Key Mapping 항목을 각각 보실수 있는데요.

       다운로드 후 고객님께서 각 조직정보에 맞는 External Key를 추가하여
       파일첨부를 통해 Mapping 작업을 진행해주시면 됩니다.(캡쳐화면 첨부)

       단, 조직연동 API를 사용설정을 'Off'에서 'On'으로 적용하면, ‘승인대기’ 중인 구성원은 모두 삭제되고
       [Admin > 구성원초대기능]도 [사용 안함]으로 자동 설정되므로 참고 바랍니다.
     
       https://developers.worksmobile.com/kr/console

    감사합니다.

    2019.07.18

    0
  • 업데이트 된 답글입니다.

    홍길동_166 작성자

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

    2019.07.18

    0
  • 업데이트 된 답글입니다.

    NAVER WORKS 공식계정

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

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

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

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

    감사합니다.

    2019.07.18

    0
이전 글서버사이드 메일 발송
다음 글캘린더 일정 생성 API 문의
목록

궁금한 점을 해결하지 못하셨나요?
지금 바로 NAVER WORKS 사용자들에게 물어보세요!