개시하다

안녕하세요, 상담 담당자입니다.
이번에 DataSpider에 워크스모바일의 서비스'라인 워커스'와 인사 DB가 연합하는 각본을 구축해 봤다.
https://line.worksmobile.com/jp/
이번 구축의 계기는 WORKS 모빌리티가 일본에서 공개한 다음과 같은 사례다.
https://line.worksmobile.com/jp/cases/noevir/
그중에서도 고객이 자사 제품인'DataSpider Servista'를 사용했는데, LINE WORKS와 협업해 사용했기 때문에 나 자신도 한번 시도해 봐야 하기 때문에 이것을 구축해 봤다.

이번에는 한번 해볼게요.

솔직히 봇 연합을 통해 다양한 일을 할 수 있을 것 같아서 먼저 사례 속 인사 DB와 라인 워커스의 사용자 계정 간 연대 부분을 구축해 봤다.
이번에는 다음과 같은 용례를 충족시키는 각본을 구축하고 싶습니다.

직원 신입 시 인사 DB를 업데이트하면 LINE WORKS 계정이 자동으로 증가

직원이 퇴사한 경우 인사 DB를 업데이트하면 라인 WORKS 계정이 자동으로 삭제됩니다

직원 이동 등의 경우 인사 DB를 업데이트하면 라인 WORKS 계정이 자동으로 업데이트됩니다

직원의 정직/복직 시 인사 DB를 업데이트하면 LINE WORKS의 계정은 자동으로 정지/회복

상기 처리에 실패한 경우 관리자에게 메일로 통지

구성 개요

이번에 준비한 환경의 개요는 다음과 같다.

사용된 DataSpider의 버전은 4.1입니다.
한편 LINE WORKS와 연결 검증이 이뤄진 시점은 2019년 10월이다.
DB 부분은 PostgreSQL이고 물론 다른 DB도 가능하며 CSV 파일 등도 대용할 수 있다.
DB 및 DataSpider를 미리 설치하고 준비합니다.

LINE WORKS 환경 준비

DataSpider 환경을 구축하기 전에 LINE WORKS와 API를 결합하여 준비합니다.
한편 이번 검증은 라인 워커스의 본 환경이 아닌'샌드박스'의 테스트 환경에서 이뤄졌다.
다음은 라인 워커스가 공개한'샌드박스'에 대한 설명문.자세한 내용은 사이트를 확인하세요.

이른바 샌드박스?
Sandbox는 현재 사용 중인 서비스와 분리된 테스트 환경입니다.
Sandbox에서는 현재 사용 중인 서비스에 영향을 주지 않고 API 및 공동 테스트를 안전하게 수행할 수 있습니다.

Sandbox 환경 준비

Sandbox 환경을 시작하려면 다음 절차를 따르십시오.
1. 다음 URL에서 "LINE WORKS Developers"웹 사이트를 방문하십시오.
https://developers.worksmobile.com/jp/
2. 화면 오른쪽 상단에 있는 "Developers Constore"를 클릭합니다.
3. 화면 왼쪽에 있는 "Sandbox"를 클릭합니다.
4. 화면 프롬프트에 따라 Sandbox 환경을 만듭니다.
5. 만들면 를 클릭하여 Sandbox용 Developer Constore를 엽니다.
앞으로의 Constore 작업은 "Sandbox용 Developer Constore"에서 진행됩니다.

API 협업의 유효성

기본적으로 API에서 공동 작업을 수행할 수 없도록 설정되어 있으므로 다음 절차에서 활성화됩니다.

"Developers Consile"에 로그인한 후 왼쪽에 있는 "조직 연합"메뉴

를 클릭합니다.

'조직 연합 사용 설정'을'on'

으로 설정

직무급/직무 등 모든 항목을 "on"

으로 설정
이 예제 스크립트는 공동 작업 API 구성을 사용합니다.
이번에는 검증 목적이 모두 on임을 확인하기 위해 아래 사이트를 참고하여 조직의 운용에 따라 디자인하십시오.
https://developers.worksmobile.com/jp/document/100300101?lang=ja
또한 이 설정 전에 추가된 사용자(관리 사용자 포함)에 대해서는 API 키로 "External Key"를 설정하지 않았습니다.다음 커뮤니티의 스왑 사전 변경 설정을 참조하십시오.
https://forum.worksmobile.com/jp/posts/149

API 인증 준비

아래 사이트의 기록을 참고하여 필요한 키 정보를 미리 얻으십시오.
https://developers.worksmobile.com/jp/document/1002002?lang=ja
필요한 물건
Domain ID 、API ID、Server API Consumer Key、Token
또 이번에는'서버 API'만 사용하기 때문에'서비스 API'에 필요한 정보는 필요 없다.
이렇게 되면 LINE WORKS와 함께 작업할 준비가 완료됩니다.

DataSpider로 인사 DB와 LINE WORKS 비프로그래밍 연결

드디어 본론에 들어섰다.
DataSpider로 인사 DB와 LINE WORKS를 연결해 보고 싶습니다.
미리 준비한 시나리오를 다음과 같이 각본에 쓴다.

또한 DataSpider의 일반적인 기능과 설정에 대해서는 이번에 언급하지 않겠습니다.
LINE WORKS에 연결할 때 필요한 작업은 다음과 같습니다.

글로벌 자원 구성

REST 연결에 대한 글로벌 리소스를 미리 설정합니다.
공식 환경과 테스트 환경에 설정된 URL은 다릅니다.
서비스: https://apis.worksmobile.com/r/{API ID]/
테스트: https://sandbox-apis.worksmobile.com/r/{API ID]/
API ID 섹션에는 미리 얻은 정보가 기재되어 있습니다.

REST 어댑터 설정

이번에는 목적에 따라 각각 다음과 같은 API를 사용한다.
입사
구성원 추가
https://developers.worksmobile.com/jp/document/100300501?lang=ja
퇴직
구성원 삭제
https://developers.worksmobile.com/jp/document/100300504?lang=ja
정직
구성원 질의
https://developers.worksmobile.com/jp/document/100300507?lang=ja
구성원 일시 중지
https://developers.worksmobile.com/jp/document/100300524?lang=ja
구성원 일시 중지 취소
https://developers.worksmobile.com/jp/document/100300525?lang=ja
어댑터를 설정할 때 경로는 다음과 같다.
또 이번에는 회사원 번호가 API 발행 시 핵심 정보로 사용됨에 따라 경로에도 직원 번호를 넣었다.

메시지 헤더 정보는 미리 획득한'Server API Consummer Key'와'Token'이 포함된 스크립트 변수를 사용합니다.설정에 관해서는 뒤에 서술할 것이다.

미세 조정 만들기

미세 조정을 만들 때 스크립트 매개 변수에 값을 설정합니다.

미리 준비한 아래의 수치를 각각 설정합니다.
Domain ID: Domain ID 설정
Server API Consumer Key 구성
"Token"설정

최후

DataSpider로 인사 DB와 LINE WORKS 비프로그래밍을 연결하면 어떨까요?기회가 된다면 대본의 상세한 내용을 따로 쓰고 싶습니다.
LINE WORKS는 개발자를 위한 API 문서와 커뮤니티로 테스트 환경이 충실하고 개발하기 쉽다.개발 중 API의 상세 사양을 알지 못하는 부분이 있었지만, 커뮤니티에서 질문하면서 개발했다.또 샌드박스 환경에서 개발하면 정식 환경에 영향을 주지 않고 테스트를 할 수 있다는 점도 좋다.
이번에는 주제를 겨냥하여 LINE WORKS의bot협업을 활용하여 사내 시스템과 사용자도 연결할 수 있도록 했다.이렇게 되면 광범위한 시스템과 사용자는 프로그래밍 없이 연결할 수 있겠지.
LINE WORKS를 가져올 때 DataSpider의 비프로그래밍 개발로 사내 시스템을 연결해 보시는 건 어떨까요?
이 블로그에서는 앞으로도 기술의'만사 상담창구'에서 상담을 받는 내용과 탄생의 노하우를 소개할 수 있을 것으로 생각한다.
앞으로도 꼭 확인해주시고 가능하면 지켜봐 주세요.
그럼 안녕히 계세요!