待办接口

class dingtalk.client.api.WorkRecord(client=None)[源代码]
add(userid, create_time, title, url, form_item_dict, originator_user_id='', source_name='')[源代码]

新增待办事项

参数:
  • userid – 用户id
  • create_time – 待办时间。Unix时间戳
  • title – 标题
  • url – 待办跳转url
  • form_item_dict – 表单列表 OrderedDict(((‘标题1’, ‘内容1’),(‘标题2’, ‘内容2’)))
  • originator_user_id – manager7078
  • source_name – 待办来源名称
dingtalk_oapi_process_workrecord_task_update(process_instance_id, tasks, agentid='')[源代码]

更新待办任务状态

参数:
  • process_instance_id – 实例id
  • tasks – 任务列表
  • agentid – 应用id
getbyuserid(userid, status, offset=0, limit=50)[源代码]

获取用户的待办事项

参数:
  • userid – 用户唯一ID
  • offset – 分页游标,从0开始,如返回结果中has_more为true,则表示还有数据,offset再传上一次的offset+limit
  • limit – 分页大小,最多50
  • status – 待办事项状态,0表示未完成,1表示完成
process_delete(process_code, agentid='')[源代码]

删除创建的审批模板

参数:
  • process_code – 模板的唯一码
  • agentid – 微应用agentId,ISV必填
process_save(name, description, form_component_list=(), process_code=None, agentid=None)[源代码]

保存审批模板

参数:
  • name – 模板名称
  • description – 模板描述
  • form_component_list – 表单列表
  • process_code – 模板的唯一码
  • agentid – 企业微应用标识
process_workrecord_create(process_code, originator_user_id, form_component_values, url, agentid='', title='')[源代码]

发起不带流程的审批实例

参数:
  • process_code – 审批模板唯一码
  • originator_user_id – 审批发起人
  • form_component_values – 表单参数列表
  • url – 实例跳转链接
  • agentid – 应用id
  • title – 实例标题
process_workrecord_task_create(process_instance_id, tasks, agentid='', activity_id='')[源代码]

创建待办任务

参数:
  • process_instance_id – 实例id
  • tasks – 任务列表
  • agentid – 应用id
  • activity_id – 节点id
process_workrecord_taskgroup_cancel(process_instance_id, activity_id, agentid='')[源代码]

批量取消任务

参数:
  • process_instance_id – 实例id
  • activity_id – 任务组id
  • agentid – 应用id
process_workrecord_update(process_instance_id, status, result, agentid='')[源代码]

同步待办实例状态

参数:
  • process_instance_id – 实例id
  • status – 实例状态,分为COMPLETED, TERMINATED
  • result – 实例结果, 如果实例状态是COMPLETED,需要设置result,分为agree和refuse
  • agentid – 应用id
update(userid, record_id)[源代码]

更新待办事项状态

参数:
  • userid – 用户id
  • record_id – 待办事项唯一id