钉钉

1.织信第三方集成钉钉

在织信工作台「团队 >> 团队设置」下，找到「第三方集成」，选择「钉钉」，点击「启用此功能」，填入企业微信CorpId、AgentId、AppKey 和 Secret后，点击「保存」。

设置项	说明
CorpId	钉钉企业ID，点击进入钉钉开发者后台中获取
AgentId	应用凭证中的AgentId，根据上一步链接到`应用开发-企业内部开发`中具体应用的应用详情中获取
AppKey	应用凭证中的AgentId，根据上一步链接到`应用开发-企业内部开发`中具体应用的应用详情中获取
Secret	应用凭证中的Secret，根据上一步链接到`应用开发-企业内部开发`中具体应用的应用详情中获取

获取示例

配置

2.在钉钉工作台添加织信Next应用

在钉钉开发者后台中「应用开发 >> 钉钉应用 >> 应用详情 >> 网页应用」中修改应用首页地址 和PC端首页地址：
链接自动生成，获取入口：「织信工作台 >> 团队设置 >> 第三方集成」。

应用首页地址为：https://${域名}/mobile/ddlogin/${cluster}/${companyId}/${钉钉CorpId}
PC端首页地址：https://${域名}/auth/ddlogin/${cluster}/${companyId}/${钉钉CorpId}

注意

如果不添加该步骤，将无法在钉钉工作通知中免登录进入织信系统中。
${cluster}:默认为0

3.添加团队成员钉钉用户ID

3.1 在钉钉管理后台「通讯录中 >> 成员管理」中点击「更多-编辑人员信息」获取【员工UserID】
3.2 在在织信工作台「团队 >> 团队设置 >> 成员 >> 编辑成员」中，填写钉钉用户ID

4.钉钉扫码登录

4.1 在织信工作台「团队 >> 团队设置 >> 登录页面」下，找到「启用团队登录页面」和「启用第三方扫码登录」，点击按钮启用。
4.2 将团队登录地址复制到钉钉应用管理中「应用详情 >> 分享设置 >> 回调域名」中。
4.3 在钉钉应用管理中「应用详情 >> 权限管理」上添加如下权限：
- 通讯录个人信息读权限
- 成员信息读权限

5.对接钉钉同步组织架构和成员

5.1 概述

在企业内部通常会使用钉钉等即时通讯工具作为日常办公的沟通工具，这类工具通常提供了组织架构管理、用户管理、通知、待办等功能。下面是对接飞书并同步组织架构和成员到织信的步骤。

5.2 实现步骤

同步钉钉组织架构前，需要先完成「第三方集成 >> 钉钉」的集成。
开通通讯录权限,在应用内-基础信息-权限管理，需要添加以下权限
- 通讯录个人信息读权限
- 成员信息读权限
- 通讯录部门信息读权限
- 邮箱等个人信息
- 企业员工手机号信息
- 个人手机号信息

5.3 实现代码

javascript

const defaultRole='normal';//授权给新用户的团队角色
const defaultPassword='123456';//新用户设置的密码,用户名为手机号
const syncMembers=true;//是否同步成员
let rootDeptId = null;

export function syncDept(){
    var deptList = getDeptList();
    console.log("deptList---------------->",JSON.stringify(deptList));
    rootDeptId = (informat.dept.queryDeptList({
        pageSize:1,
        filter:{
            conditionList:[
                {"fieldId":"parentId","opt":"isnull"}
            ]
        }
    })[0] || {}).id;
    console.log('rootDeptId', rootDeptId);
    if(deptList!=null){
    deptList.forEach(item=>{
            var dept_id = `${item.dept_id}`;
      var dept=informat.dept.getDept(dept_id);
            console.log('dept_id', dept_id);
            if(dept_id === '1') return;
      if (dept==null) {
        console.log('新增部门',item);
        informat.dept.addDept({
                  'id': dept_id,
                  'name': item.name,
                  'remark': item.name,
                  'parentId': item.parent_id === 1 ? rootDeptId : `${item.parent_id}`
              });
      }else{
        console.log('编辑部门',item);
        informat.dept.updateDept({
                'id': dept_id,
                  'name': item.name,
                    'parentId': item.parent_id === 1 ? rootDeptId : `${item.parent_id}`
              });
      }
    });
  }
    //同步成员
  if(syncMembers){
    syncMemberList([{ dept_id: 1 }].concat(deptList));
  }
}

function syncMemberList(deptList){
   if(Array.isArray(deptList)) {
       deptList.forEach(dept => {
           const memberList = getMemberList(dept.dept_id);
           memberList.forEach(member => {
                var memberList=informat.company.queryCompanyMemberList({
                    pageIndex:1,
                    pageSize:1,
                    filter:{
                        conditionList:[{
                            "fieldId":"dingtalkUserId",
                            "opt":"eq",
                            "value":member.userid
                        }]
                    }
                });
                var departmentList=getDeptIdListWithDingtalkDeptIdList(member.dept_id_list);
                if(memberList.length==0){//新增
                    var accountId=addAccount(member);
                    var roleList=defaultRole==null?[]:[defaultRole];
                    console.log('新增团队成员',member, departmentList);
                    informat.company.addCompanyMember(accountId, departmentList, roleList);
                    informat.company.updateCompanyMember({
                        id: accountId,
                        dingtalkUserId: member.userid,
                    });
                }else{//编辑
                    console.log('编辑团队成员',member, departmentList);
                    var member=memberList[0];
                    informat.company.updateCompanyMember({
                        id: member.id,
                        departmentList: departmentList,
                    });
                }
           })
       })
   } else {
       console.log("syncMemberList, deptList is not array. deptList: ", deptList);
   }
}

function getDeptIdListWithDingtalkDeptIdList(idList) {
    const rootIndex = idList.indexOf(1);
    if(rootIndex > -1) {
        idList.splice(rootIndex, 1, rootDeptId);
    }
    return idList.map(id => `${id}`)
}

function getMemberList(dept_id){
    var dingtalkAccessToken=informat.app.dingtalkAccessToken();
    var url = `https://oapi.dingtalk.com/topapi/user/listid?access_token=${dingtalkAccessToken}`;
    var rs = httpPost(url,JSON.stringify({
            "dept_id": dept_id
    }));
    const memberList = [];
    if(rs.errcode === 0) {
        rs.result.userid_list.forEach(id => {
            memberList.push(getMemeberInfo(id));
        });
    }
    return memberList;
}

function getMemeberInfo(user_id){
    var dingtalkAccessToken=informat.app.dingtalkAccessToken();
    var url = `https://oapi.dingtalk.com/topapi/v2/user/get?access_token=${dingtalkAccessToken}`;
    var rs = httpPost(url,JSON.stringify({
            "language":"zh_CN",
            "userid": user_id
    }));
    return rs.result
}

function getDeptList(dept_id, result = []){
    var dingtalkAccessToken=informat.app.dingtalkAccessToken();
    var url = `https://oapi.dingtalk.com/topapi/v2/department/listsub?access_token=${dingtalkAccessToken}`;
    //传入对应部门的id会识别该部门下的所有子部门id
    const data = {
        "language":"zh_CN"
    }
    if(dept_id) {
        data.dept_id = dept_id
    }
    var rs = httpPost(url,JSON.stringify(data));
    if(rs.errcode) return result;
    const deptList = rs.result
    deptList.forEach(item => {
        // var detail = getDeptInfo(id);
        result.push(item);
        getDeptList(item.dept_id, result)
    })
    return result
}

function getDeptInfo(dept_id){
    var dingtalkAccessToken=informat.app.dingtalkAccessToken();
    var url = `https://oapi.dingtalk.com/topapi/v2/department/get?access_token=${dingtalkAccessToken}`;
    var rs = httpPost(url,JSON.stringify({
            "language":"zh_CN",
            "dept_id": dept_id
        }));
    return rs.result;
}

function addAccount(item){
    var mobile=item.mobile;
    if(mobile==null){
        throw new Error('员工手机号不能为空，请开放查看手机权限');
    }
    if(mobile.length==14){
        mobile=mobile.substr(3);
    }
    var accountList=informat.system.queryAccountList({
        pageIndex: 1,
        pageSize: 1,
        filter: {
            conditionList: [
                {
                    fieldId: 'mobileNo',
                    opt: 'eq',
                    value: mobile
                }
            ]
        }
    });
    var accountId=null;
    if(accountList.length==0){//账号不存在
        console.log('新增账号',item);
        accountId=informat.system.addAccount({
            oid: item.userid,
            name: item.name,
            avatar: 'pic15.png',
            userName: mobile,
            mobileNo: mobile,
            email: item.email,
            password: defaultPassword
        });
    }else{
        var oldAccount=accountList[0];
        accountId=oldAccount.id;
        console.log('编辑账号',item, oldAccount);
        informat.system.updateAccount({
            id: oldAccount.id,
            name: item.name,
            userName: mobile,
            mobileNo: mobile
        }); 
    }
    return accountId;
}


function httpPost(url,body){
    console.log("url----------------->",url);
    console.log("body----------------->",body);
  var resp=informat.http.request({
        headers: {
            "Content-Type": "application/json;chartset=utf-8"
        },
        method: "POST",
        timeout: 30000,
        url: url,
        body:body,
    });
  if (200 != resp.statusCode()) {
    console.log('url',url)
    console.log('resp statusCode',resp.statusCode());
    console.log('resp body',resp.body())
        throw new Error('发起http请求失败，请联系开发人员');
    }
    console.log("url------->",url)
    console.log("resp----------->",resp.body());
  return JSON.parse(resp.body());
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222

5.4 常见错误

部门接口错误码
成员接口错误码

钉钉 ​

1.织信第三方集成钉钉 ​

2.在钉钉工作台添加织信Next应用 ​

3.添加团队成员钉钉用户ID ​

4.钉钉扫码登录 ​

5.对接钉钉同步组织架构和成员 ​

5.1 概述 ​

5.2 实现步骤 ​

5.3 实现代码 ​

5.4 常见错误 ​

钉钉