230 lines
10 KiB
MySQL
230 lines
10 KiB
MySQL
|
-- =============================================
|
|||
|
|
-- 钉钉开放平台初始化数据
|
|||
|
|
--
|
|||
|
|
-- 执行后需配置 token（OAUTH2 读取 token 列，非 api_key）：
|
|||
|
|
-- UPDATE api_datasource_platform SET token = '你的oapi access_token'
|
|||
|
|
-- WHERE platform_code = 'dingtalk';
|
|||
|
|
-- =============================================
|
|||
|
|
|
|||
|
|
-- 1. 创建钉钉平台
|
|||
|
|
INSERT INTO api_datasource_platform (
|
|||
|
|
tenant_id, creator, created_at, updater, updated_at,
|
|||
|
|
platform_code, platform_name, description, status,
|
|||
|
|
api_base_url, auth_type,
|
|||
|
|
auth_config,
|
|||
|
|
rate_limit_per_minute, rate_limit_per_hour,
|
|||
|
|
concurrency_limit, request_timeout_ms, max_retries, retry_delay_ms
|
|||
|
|
) VALUES (
|
|||
|
|
1, 'admin', NOW(), 'admin', NOW(),
|
|||
|
|
'dingtalk', '钉钉', '钉钉开放平台数据同步', 'ACTIVE',
|
|||
|
|
'https://oapi.dingtalk.com', 'OAUTH2',
|
|||
|
|
'{
|
|||
|
|
"token_in_query": true,
|
|||
|
|
"query_key": "access_token"
|
|||
|
|
}'::jsonb,
|
|||
|
|
60, 3600, 5, 30000, 3, 1000
|
|||
|
|
);
|
|||
|
|
|
|||
|
|
-- 2. 部门列表（递归遍历全量部门树）
|
|||
|
|
-- 先从根（不传 dept_id）获取一级部门，再对每个子部门递归调用获取下级
|
|||
|
|
-- 请求：POST，access_token 在 URL 查询参数中
|
|||
|
|
-- 响应：{"errcode":0,"errmsg":"ok","result":[{...}]}
|
|||
|
|
INSERT INTO api_interface (
|
|||
|
|
tenant_id, creator, created_at, updater, updated_at,
|
|||
|
|
platform_id, name, code, url, method, status, auth_type,
|
|||
|
|
request_config, response_config, table_definition
|
|||
|
|
) VALUES (
|
|||
|
|
1, 'admin', NOW(), 'admin', NOW(),
|
|||
|
|
(SELECT id FROM api_datasource_platform WHERE platform_code = 'dingtalk'),
|
|||
|
|
'部门列表', 'department_list',
|
|||
|
|
'/topapi/v2/department/listsub', 'POST', 'active', 'inherit',
|
|||
|
|
'{
|
|||
|
|
"parameters_location": "query",
|
|||
|
|
"page_param": "cursor",
|
|||
|
|
"page_size_param": "pageSize",
|
|||
|
|
"language": "zh_CN",
|
|||
|
|
"recursive": {
|
|||
|
|
"key_field": "dept_id",
|
|||
|
|
"target_param": "dept_id"
|
|||
|
|
},
|
|||
|
|
"max_recursive_depth": 20
|
|||
|
|
}'::jsonb,
|
|||
|
|
'{
|
|||
|
|
"success_field": "errcode",
|
|||
|
|
"success_value": 0,
|
|||
|
|
"message_field": "errmsg",
|
|||
|
|
"list_path": "result"
|
|||
|
|
}'::jsonb,
|
|||
|
|
'{
|
|||
|
|
"table_name": "dingtalk_department",
|
|||
|
|
"columns": [
|
|||
|
|
{"name": "dept_id", "type": "BIGINT", "comment": "部门ID"},
|
|||
|
|
{"name": "name", "type": "VARCHAR(300)", "comment": "部门名称"},
|
|||
|
|
{"name": "parent_id", "type": "BIGINT", "comment": "父部门ID"},
|
|||
|
|
{"name": "create_dept_group", "type": "BOOLEAN", "comment": "是否同步创建关联企业群"},
|
|||
|
|
{"name": "auto_add_user", "type": "BOOLEAN", "comment": "新人是否自动加入部门群"}
|
|||
|
|
],
|
|||
|
|
"conflict_keys": ["dept_id"]
|
|||
|
|
}'::jsonb
|
|||
|
|
);
|
|||
|
|
|
|||
|
|
-- 3. 部门用户列表（prefetch→department_list，游标分页）
|
|||
|
|
-- 先递归获取全量部门树，再对每个部门分页拉取用户
|
|||
|
|
-- dept_id 为必填，通过 prefetch 从部门列表注入
|
|||
|
|
-- 响应：result.list（用户数组），result.has_more（是否还有更多），result.next_cursor（下一游标）
|
|||
|
|
INSERT INTO api_interface (
|
|||
|
|
tenant_id, creator, created_at, updater, updated_at,
|
|||
|
|
platform_id, name, code, url, method, status, auth_type,
|
|||
|
|
request_config, response_config, table_definition
|
|||
|
|
) VALUES (
|
|||
|
|
1, 'admin', NOW(), 'admin', NOW(),
|
|||
|
|
(SELECT id FROM api_datasource_platform WHERE platform_code = 'dingtalk'),
|
|||
|
|
'部门用户列表', 'user_list',
|
|||
|
|
'/topapi/v2/user/list', 'POST', 'active', 'inherit',
|
|||
|
|
'{
|
|||
|
|
"parameters_location": "query",
|
|||
|
|
"page_param": "cursor",
|
|||
|
|
"page_size_param": "size",
|
|||
|
|
"cursor_pagination": true,
|
|||
|
|
"size": 100,
|
|||
|
|
"order_field": "modify_desc",
|
|||
|
|
"language": "zh_CN",
|
|||
|
|
"initial_cursor": 0,
|
|||
|
|
"prefetch": {
|
|||
|
|
"url": "/topapi/v2/department/listsub",
|
|||
|
|
"method": "POST",
|
|||
|
|
"response_path": "result",
|
|||
|
|
"target_param": "dept_id",
|
|||
|
|
"value_field": "dept_id"
|
|||
|
|
}
|
|||
|
|
}'::jsonb,
|
|||
|
|
'{
|
|||
|
|
"success_field": "errcode",
|
|||
|
|
"success_value": 0,
|
|||
|
|
"message_field": "errmsg",
|
|||
|
|
"list_path": "result.list",
|
|||
|
|
"cursor_field": "result.next_cursor",
|
|||
|
|
"has_more_field": "result.has_more"
|
|||
|
|
}'::jsonb,
|
|||
|
|
'{
|
|||
|
|
"table_name": "dingtalk_user",
|
|||
|
|
"columns": [
|
|||
|
|
{"name": "userid", "type": "VARCHAR(100)", "comment": "用户userId"},
|
|||
|
|
{"name": "unionid", "type": "VARCHAR(200)", "comment": "用户唯一标识"},
|
|||
|
|
{"name": "name", "type": "VARCHAR(200)", "comment": "用户姓名"},
|
|||
|
|
{"name": "avatar", "type": "TEXT", "comment": "头像地址"},
|
|||
|
|
{"name": "state_code", "type": "VARCHAR(20)", "comment": "国际电话区号"},
|
|||
|
|
{"name": "mobile", "type": "VARCHAR(50)", "comment": "手机号码"},
|
|||
|
|
{"name": "hide_mobile", "type": "BOOLEAN", "comment": "是否号码隐藏"},
|
|||
|
|
{"name": "telephone", "type": "VARCHAR(50)", "comment": "分机号"},
|
|||
|
|
{"name": "job_number", "type": "VARCHAR(100)", "comment": "员工工号"},
|
|||
|
|
{"name": "title", "type": "VARCHAR(200)", "comment": "职位"},
|
|||
|
|
{"name": "email", "type": "VARCHAR(200)", "comment": "员工邮箱"},
|
|||
|
|
{"name": "org_email", "type": "VARCHAR(200)", "comment": "企业邮箱"},
|
|||
|
|
{"name": "work_place", "type": "VARCHAR(300)", "comment": "办公地点"},
|
|||
|
|
{"name": "remark", "type": "TEXT", "comment": "备注"},
|
|||
|
|
{"name": "dept_id_list", "type": "JSONB", "comment": "所属部门id列表"},
|
|||
|
|
{"name": "dept_order", "type": "INT", "comment": "员工在部门中的排序"},
|
|||
|
|
{"name": "extension", "type": "TEXT", "comment": "扩展属性"},
|
|||
|
|
{"name": "hired_date", "type": "BIGINT", "comment": "入职时间"},
|
|||
|
|
{"name": "active", "type": "BOOLEAN", "comment": "是否激活钉钉"},
|
|||
|
|
{"name": "admin", "type": "BOOLEAN", "comment": "是否企业管理员"},
|
|||
|
|
{"name": "boss", "type": "BOOLEAN", "comment": "是否企业老板"},
|
|||
|
|
{"name": "leader", "type": "BOOLEAN", "comment": "是否部门主管"},
|
|||
|
|
{"name": "exclusive_account", "type": "BOOLEAN", "comment": "是否企业账号"}
|
|||
|
|
],
|
|||
|
|
"conflict_keys": ["userid"]
|
|||
|
|
}'::jsonb
|
|||
|
|
);
|
|||
|
|
|
|||
|
|
-- 4. 考勤数据查询（单个用户单日，prefetch→user_list）
|
|||
|
|
-- 需先同步 user_list 获取全量用户，再对每个用户调用此接口查询考勤数据
|
|||
|
|
-- userid 通过 prefetch 从 user_list 注入，work_date 固定为当天日期
|
|||
|
|
-- 响应：result 对象（包含 attendance_result_list/check_record_list/approve_list 等）
|
|||
|
|
-- 注意：当前代码支持两级 prefetch 链（即本接口 prefetch→user_list，
|
|||
|
|
-- user_list 自有 prefetch→department_list），但 user_list 的 dept_id 依赖
|
|||
|
|
-- 在作为 prefetch 来源时不会自动解析。若需全量同步所有用户的考勤数据，
|
|||
|
|
-- 建议先手动同步 user_list 和 department_list，再同步此接口。
|
|||
|
|
-- 使用前请将 work_date 更新为目标日期，如 '2026-06-03'
|
|||
|
|
INSERT INTO api_interface (
|
|||
|
|
tenant_id, creator, created_at, updater, updated_at,
|
|||
|
|
platform_id, name, code, url, method, status, auth_type,
|
|||
|
|
request_config, response_config, table_definition
|
|||
|
|
) VALUES (
|
|||
|
|
1, 'admin', NOW(), 'admin', NOW(),
|
|||
|
|
(SELECT id FROM api_datasource_platform WHERE platform_code = 'dingtalk'),
|
|||
|
|
'考勤数据查询', 'attendance_getupdatedata',
|
|||
|
|
'/topapi/attendance/getupdatedata', 'POST', 'active', 'inherit',
|
|||
|
|
'{
|
|||
|
|
"parameters_location": "query",
|
|||
|
|
"prefetch": {
|
|||
|
|
"url": "/topapi/v2/user/list",
|
|||
|
|
"method": "POST",
|
|||
|
|
"response_path": "result.list",
|
|||
|
|
"target_param": "userid",
|
|||
|
|
"value_field": "userid"
|
|||
|
|
},
|
|||
|
|
"work_date": "2026-06-03"
|
|||
|
|
}'::jsonb,
|
|||
|
|
'{
|
|||
|
|
"success_field": "errcode",
|
|||
|
|
"success_value": 0,
|
|||
|
|
"message_field": "errmsg",
|
|||
|
|
"list_path": "result",
|
|||
|
|
"single_record": true
|
|||
|
|
}'::jsonb,
|
|||
|
|
'{
|
|||
|
|
"table_name": "dingtalk_attendance",
|
|||
|
|
"columns": [
|
|||
|
|
{"name": "userid", "type": "VARCHAR(100)", "comment": "用户userId"},
|
|||
|
|
{"name": "work_date", "type": "VARCHAR(30)", "comment": "查询日期"},
|
|||
|
|
{"name": "corpId", "type": "VARCHAR(100)", "comment": "企业corpId"},
|
|||
|
|
{"name": "attendance_result_list", "type": "JSONB", "comment": "打卡结果列表"},
|
|||
|
|
{"name": "check_record_list", "type": "JSONB", "comment": "打卡详情列表"},
|
|||
|
|
{"name": "approve_list", "type": "JSONB", "comment": "审批单列表"},
|
|||
|
|
{"name": "rest_time_vo_list", "type": "JSONB", "comment": "班次内休息信息"},
|
|||
|
|
{"name": "rest_end_time", "type": "BIGINT", "comment": "休息结束时间"},
|
|||
|
|
{"name": "rest_begin_time", "type": "BIGINT", "comment": "休息开始时间"}
|
|||
|
|
],
|
|||
|
|
"conflict_keys": ["userid", "work_date"]
|
|||
|
|
}'::jsonb
|
|||
|
|
);
|
|||
|
|
|
|||
|
|
-- 5. 角色列表（偏移量分页，offset/size + hasMore）
|
|||
|
|
-- 响应：result.list（角色组数组），result.hasMore（是否还有更多）
|
|||
|
|
-- 每个角色组内包含 roles 数组（{id, name}）你
|
|||
|
|
INSERT INTO api_interface (
|
|||
|
|
tenant_id, creator, created_at, updater, updated_at,
|
|||
|
|
platform_id, name, code, url, method, status, auth_type,
|
|||
|
|
request_config, response_config, table_definition
|
|||
|
|
) VALUES (
|
|||
|
|
1, 'admin', NOW(), 'admin', NOW(),
|
|||
|
|
(SELECT id FROM api_datasource_platform WHERE platform_code = 'dingtalk'),
|
|||
|
|
'角色列表', 'role_list',
|
|||
|
|
'/topapi/role/list', 'POST', 'active', 'inherit',
|
|||
|
|
'{
|
|||
|
|
"parameters_location": "query",
|
|||
|
|
"page_param": "offset",
|
|||
|
|
"page_size_param": "size",
|
|||
|
|
"size": 200,
|
|||
|
|
"offset": 0,
|
|||
|
|
"pagination_mode": "offset"
|
|||
|
|
}'::jsonb,
|
|||
|
|
'{
|
|||
|
|
"success_field": "errcode",
|
|||
|
|
"success_value": 0,
|
|||
|
|
"message_field": "errmsg",
|
|||
|
|
"list_path": "result.list",
|
|||
|
|
"has_more_field": "result.has_more"
|
|||
|
|
}'::jsonb,
|
|||
|
|
'{
|
|||
|
|
"table_name": "dingtalk_role",
|
|||
|
|
"columns": [
|
|||
|
|
{"name": "groupId", "type": "BIGINT", "comment": "角色组ID"},
|
|||
|
|
{"name": "name", "type": "VARCHAR(200)", "comment": "角色组名称"},
|
|||
|
|
{"name": "roles", "type": "JSONB", "comment": "角色列表"}
|
|||
|
|
],
|
|||
|
|
"conflict_keys": ["groupId"]
|
|||
|
|
}'::jsonb
|
|||
|
|
);
|