​

企業 OA システムと DingTalk 連絡先の同期

​

前提条件

​

ステップ 1：アプリ認証情報の取得

1. 対象のアプリを選択し、アプリ詳細ページに移動して、ベーシック情報 > 認証情報とベーシック情報 をクリックします。
2. クライアント ID と Client Secret を取得します。

​

ステップ 2：API 権限の追加

​

ステップ 3：アプリのアクセス認証情報 アクセストークン の取得

​

重要

• サーバー API の差異については、旧バージョンサーバー API と新バージョンサーバー API の違いを参照してください。
• サーバー API インターフェース SDK のダウンロードについては、サーバー SDK ダウンロードを参照してください。

public void getAccessToken() throws ApiException {
        DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.io/gettoken");
        OapiGettokenRequest req = new OapiGettokenRequest();
        req.setAppkey("dingxxxxxxxxxhgn");
        req.setAppsecret("9G_xxxxxxxxxxxxxxx1JDf0Qq3nexxxxxxxxGIO");
        req.setHttpMethod("GET");
        OapiGettokenResponse rsp = client.execute(req);
        System.out.println(rsp.getBody());
    }

​

ステップ 4：連絡先同期に関するフロー

1. DingTalk 連絡先情報を企業 OA システムの連絡先に同期する： 同期実現のポイントは、DingTalk 連絡先内の情報に変更があった場合、企業 OA システムの連絡先にも対応する操作が反映されることを保証する点にあります。
   1. まず、企業内のすべての社員情報を取得するドキュメントを参考に、現在の DingTalk 組織構成情報をすべて企業 OA システムの連絡先内に取得します。
   2. DingTalk が提供するイベントサブスクリプション機能を使用し、連絡先イベントをサブスクライブします。DingTalk 連絡先内の変更に応じて、関連するコールバックイベント情報がプッシュされます。連絡先イベントのプッシュ情報フォーマットは、連絡先を参照してください。
   3. 企業 OA システムで DingTalk からプッシュされた連絡先イベントを受信・処理し、企業 OA システムの連絡先情報を同期して更新します。
2. 企業 OA システムの連絡先情報を DingTalk 連絡先に更新する： 企業 OA システムの連絡先情報に変更が生じた場合、DingTalk 連絡先情報を同期して更新し、連絡先情報の一貫性を確保する必要があります。
   1. 企業 OA システムの連絡先内に部門が作成された場合、部門作成 API を呼び出し、企業独自の OA システム内の当該部門の階層と部門名に基づき、DingTalk クライアントサイドで同じ部門階層と部門名を作成します。
       public void deptCreate() throws ApiException {
              DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/v2/department/create");
              OapiV2DepartmentCreateRequest req = new OapiV2DepartmentCreateRequest();
              req.setParentId(1L);
              req.setOuterDept(true);
              req.setHideDept(false);
              req.setCreateDeptGroup(true);
              req.setOrder(1L);
              req.setName("1019テスト部門");
              req.setSourceIdentifier("1019テスト部門");
              req.setOuterPermitUsers("manager7675,01472825524039877041");
              req.setOuterDeptOnlySelf(true);
              OapiV2DepartmentCreateResponse rsp = client.execute(req, getAccessToken());
              System.out.println(rsp.getBody());
          }
      

​

説明

1. サーバー API の ロールグループの作成 インターフェースを呼び出し、ロールグループ情報を作成します。
   public void addRoleGroup() throws ApiException {
           DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.io/role/add_role_group");
           OapiRoleAddrolegroupRequest req = new OapiRoleAddrolegroupRequest();
           req.setName("1019テストロールグループ");
           OapiRoleAddrolegroupResponse rsp = client.execute(req, getAccessToken());
           System.out.println(rsp.getBody());
       }
   
2. サーバー API のロール作成インターフェースを呼び出し、企業のロール情報を作成します。
     public void addRole() throws ApiException {
           DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.io/role/add_role");
           OapiRoleAddRoleRequest req = new OapiRoleAddRoleRequest();
           req.setRoleName("1019テストロール");
           req.setGroupId(3168010875L);
           OapiRoleAddRoleResponse rsp = client.execute(req, getAccessToken());
           System.out.println(rsp.getBody());
       }
   
3. ユーザーの作成 インターフェースを呼び出し、企業 OA システム内の各部門の社員を DingTalk の対応する部門に作成・追加します。本ステップでユーザーを追加する際、同時に当該社員のロール情報を追加することができます。
   public void createUser() throws ApiException {
           DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/v2/user/create");
           OapiV2UserCreateRequest req = new OapiV2UserCreateRequest();
           req.setUserid("manger7666");
           req.setName("1009テストユーザー");
           req.setSeniorMode(false);
           req.setMobile("152****3025");
           req.setTitle("技術ディレクター");
           req.setEmail("test***@xx.com");
           req.setOrgEmail("test***@xxx.com");
           req.setOrgEmailType("profession");
           ArrayList<OapiV2UserCreateRequest.DeptTitle> deptTitles = new ArrayList<>();
           OapiV2UserCreateRequest.DeptTitle deptTitle = new OapiV2UserCreateRequest.DeptTitle();
           deptTitle.setDeptId(724960197L);
           deptTitle.setTitle("シニア技術ディレクター");
           deptTitles.add(deptTitle);
           req.setDeptTitleList(deptTitles);
           req.setHideMobile(false);
           req.setTelephone("010-8xxxxx6-2345");
           req.setJobNumber("202210190001");
           req.setHiredDate(1666143772000L);
           req.setWorkPlace("アリババセンター****");
           req.setRemark("備考情報");
           req.setDeptIdList("724960197");
           List<OapiV2UserCreateRequest.DeptOrder> deptOrderList = new ArrayList<OapiV2UserCreateRequest.DeptOrder>();
           OapiV2UserCreateRequest.DeptOrder deptOrder = new OapiV2UserCreateRequest.DeptOrder();
           deptOrder.setDeptId(724960197L);
           deptOrder.setOrder(1L);
           deptOrderList.add(deptOrder);
           req.setDeptOrderList(deptOrderList);
           req.setExtension("{\"趣味\":\"[趣味](http://test.com?userid=#userid#&corpid=#corpid#)\"}");
           req.setManagerUserid("manager7675");
           req.setLoginEmail("test****@xxx.com");
           OapiV2UserCreateResponse rsp = client.execute(req, getAccessToken());
           System.out.println(rsp.getBody());
       }