Membuat, mengambil, memperbarui, dan menghapus karyawan

​

Hasil yang diharapkan

​

Ringkasan alur integrasi

1. Panggil Server API Buat pengguna untuk membuat pengguna dan memperoleh userid.
   • Untuk menambahkan karyawan ke Departemen root, teruskan 1 sebagai parameter. Contoh ini menambahkan karyawan ke Departemen root.
   • Untuk menambahkan karyawan ke departemen tertentu, panggil terlebih dahulu Peroleh daftar ID subdepartemen untuk mendapatkan ID departemen, lalu teruskan sebagai parameter departemen saat membuat pengguna.
2. Dengan userid, panggil Server API Kueri detail pengguna untuk mengambil informasi detail pengguna.
3. Dengan userid, panggil Server API Perbarui informasi pengguna untuk memperbarui informasi pengguna.
4. Dengan userid, panggil Server API Hapus pengguna untuk menghapus pengguna.

​

Prasyarat

​

Langkah 1: Peroleh kredensial aplikasi

1. Pilih aplikasi target untuk masuk ke halaman detail aplikasi, lalu klik Basic information > Credentials and basic information.
2. Peroleh client ID dan Client Secret.

​

Langkah 2: Tambahkan izin API

​

Langkah 3: Peroleh kredensial akses aplikasi (access token)

​

Penting

• Untuk perbedaan antar versi Server API, lihat API lama vs. API Baru.
• Untuk mengunduh SDK Server API, lihat Unduh SDK sisi server.

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());
    }

​

Langkah 4: Panggil API Kontak

1. Panggil Server API Buat pengguna untuk membuat pengguna dan memperoleh userid.
   public void createUser() throws ApiException {
           DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/v2/user/create");
           OapiV2UserCreateRequest req = new OapiV2UserCreateRequest();
           req.setUserid("manger7676");
           req.setName("Pengguna Uji 1009");
           req.setSeniorMode(false);
           req.setMobile("152****3025");
           req.setTitle("Direktur Teknis");
           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("Direktur Teknis Senior");
           deptTitles.add(deptTitle);
           req.setDeptTitleList(deptTitles);
           req.setHideMobile(false);
           req.setTelephone("010-8xxxxx6-2345");
           req.setJobNumber("202210190001");
           req.setHiredDate(1666143772000L);
           req.setWorkPlace("Alibaba Center******");
           req.setRemark("Catatan");
           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("{\"Hobby\":\"[Hobi](http://test.com?userid=#userid#&corpid=#corpid#)\"}");
           req.setManagerUserid("manager7676");
           req.setLoginEmail("test****@xxx.com");
           OapiV2UserCreateResponse rsp = client.execute(req, "access_token");
           System.out.println(rsp.getBody());
       }
   
   • Untuk menambahkan karyawan ke Departemen root, teruskan 1 sebagai parameter. Contoh ini menambahkan karyawan ke Departemen root.
   • Untuk menambahkan karyawan ke departemen tertentu, panggil terlebih dahulu Peroleh daftar ID subdepartemen untuk mendapatkan ID departemen, lalu teruskan sebagai parameter departemen saat membuat pengguna.
   public void departmentListSubId() throws ApiException {
           DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/v2/department/listsubid");
           OapiV2DepartmentListsubidRequest req = new OapiV2DepartmentListsubidRequest();
           req.setDeptId(1L);
           OapiV2DepartmentListsubidResponse rsp = client.execute(req, "access_token");
           System.out.println(rsp.getBody());
       }
   
2. Dengan userid, panggil Server API Kueri detail pengguna untuk mengambil informasi detail pengguna.

​

Catatan

 public void userInfo() throws ApiException {
        DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/v2/user/get");
        OapiV2UserGetRequest req = new OapiV2UserGetRequest();
        req.setUserid("manger7676");
        req.setLanguage("zh_CN");
        OapiV2UserGetResponse rsp = client.execute(req, "access_token");
        System.out.println(rsp.getBody());
    }

3. Dengan userid, panggil Server API Perbarui informasi pengguna untuk memperbarui informasi pengguna.

​

Catatan

public void userModify() throws ApiException {
        DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/v2/user/update");
        OapiV2UserUpdateRequest req = new OapiV2UserUpdateRequest();
        req.setUserid("manger7676");
        req.setName("Xiao Ding");
        req.setHideMobile(false);
        req.setTelephone("010-86*****6-2345");
        req.setJobNumber("202210190002");
        req.setTitle("Direktur Teknis");
        req.setEmail("test*****@xxx.com");
        req.setWorkPlace("Future Park");
        req.setRemark("Catatan yang diperbarui");
        req.setDeptIdList("1");
        List<OapiV2UserUpdateRequest.DeptOrder> list2 = new ArrayList<OapiV2UserUpdateRequest.DeptOrder>();
        OapiV2UserUpdateRequest.DeptOrder obj3 = new OapiV2UserUpdateRequest.DeptOrder();
        list2.add(obj3);
        obj3.setDeptId(1L);
        obj3.setOrder(1L);
        req.setDeptOrderList(list2);
        req.setExtension("{\"Hobby\":\"Travel\",\"Age\":\"24\"}");
        req.setSeniorMode(false);
        req.setHiredDate(1633017600000L);
        req.setLanguage("zh_CN");
        OapiV2UserUpdateResponse rsp = client.execute(req, "access_token");
        System.out.println(rsp.getBody());
    }

4. Dengan userid, panggil Server API Hapus pengguna untuk menghapus pengguna.
   public void userDelete() throws ApiException {
           DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/v2/user/delete");
           OapiV2UserDeleteRequest req = new OapiV2UserDeleteRequest();
           req.setUserid("manager7676");
           OapiV2UserDeleteResponse rsp = client.execute(req, "access_token");
           System.out.println(rsp.getBody());
       }