开发者社区 问答 正文

钉钉发起审批实例接口,请假/调休控件组如何传参?

钉钉发起审批实例接口,请假/调休控件组如何传参?

展开
收起
真的很搞笑 2023-12-28 07:48:27 285 分享 版权
2 条回答
写回答
取消 提交回答
  • 在钉钉中,通过API发起审批实例并包含请假/调休控件组时,需要按照特定的参数格式和结构进行传参。以下是一个基本的示例,展示了如何使用JSON格式传递请假/调休控件组的参数:

    {
      "processCode": "your_process_code", // 审批流的唯一标识码
      "originatorUserId": "your_user_id", // 发起审批的用户ID
      "deptId": "your_dept_id", // (可选)发起审批的部门ID
      "formComponentValues": [
        {
          "componentName": "leave_type", // 控件名称,根据实际情况填写
          "componentValue": "1" // 假设“1”代表事假,具体值根据你的审批模板定义
        },
        {
          "componentName": "start_date", // 开始日期控件名称
          "componentValue": "2023-04-01" // 开始日期,格式为YYYY-MM-DD
        },
        {
          "componentName": "end_date", // 结束日期控件名称
          "componentValue": "2023-04-03" // 结束日期,格式为YYYY-MM-DD
        },
        {
          "componentName": "reason", // 原因描述控件名称
          "componentValue": "个人原因需要请假" // 请假原因
        },
        {
          "componentName": "adjust_type", // (可选)调休类型控件名称,如果有调休选项的话
          "componentValue": "1" // 假设“1”代表正常调休,具体值根据你的审批模板定义
        }
      ]
    }
    

    请注意,以上示例中的控件名称(如leave_typestart_dateend_date等)和对应的值需要根据你的实际审批模板中的控件设置来调整。

    在实际使用时,你需要将这个JSON对象转换为字符串,并作为POST请求的主体发送到钉钉的“发起审批实例”接口。

    2023-12-29 14:22:47
    赞同 展开评论
  • 面对过去,不要迷离;面对未来,不必彷徨;活在今天,你只要把自己完全展示给别人看。

    在钉钉中,发起审批实例时,可以通过控件组参数来传递请假或调休的信息。具体来说,可以在创建审批单时添加“请假/调休套件”,审批通过后,系统会自动在钉钉状态栏显示请假时间,并扣除对应的假期余额。

    此外,根据是否指定审批人,调用接口的方式有所不同。如果指定审批人,可以通过approvers或approvers_v2参数来指定审批人。其中,approvers_v2支持或签和会签。如果不指定审批人,审批流程会复用审批后台的设置。在这种情况下,调用接口时不传入approvers或approvers_v2参数,会自动复用在审批管理后台预设的审批人。

    请注意,无论是哪种方式,都需要在调用接口前确保已经为应用添加了接口权限。同时,对于企业内部应用和第三方企业应用,获取审批单流程中的节点信息接口的调用方式也存在差异。

    2023-12-28 17:48:04
    赞同 展开评论