# 创建审批定义

创建审批定义



**标签**：`审批定义` 


## 请求说明
| 字段          | 值                  |
|--------------|---------------------|
| **<div style="white-space: nowrap;">请求地址</div>**  | https://openapi.wps.cn/v7/workflow/approval_defines          |
| **<div style="white-space: nowrap;">HTTP 方法</div>** | `POST`    |
| **<div style="white-space: nowrap;">接口描述</div>**  | 新建一个审批定义 |
| **<div style="white-space: nowrap;">签名方式</div>**  | [KSO-1](https://open.wps.cn/documents/app-integration-dev/wps365/server/api-description/signature-description) |
| **<div style="white-space: nowrap;">限频策略</div>** | 无 |
| **<div style="white-space: nowrap;">权限要求</div>** | <div><div>创建审批定义(应用授权) `kso.workflow_approval_define.readwrite`</div></div> |


## 请求头 (Headers)
| 属性名 | 类型 | 是否必填 | 描述 | 可选值 |
|-------|------|------|-------|-------|
| <div style="white-space: nowrap;">X-Kso-Id-Type</div> | `string` | 否 | 类型<br>  * **internal** - 内部<br>  * **external** - 外部<br> | `internal`, `external` 







## 请求体(Body)
**请求体格式:** `application/json`
<OpenapiRenderTable  dataSource='[{"key":"creator","name":"creator","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>创建者</p>\n","children":[]},{"key":"form_defines","name":"form_defines","deprecated":false,"type":"array[object]","required":"是","enum":[],"xEnum":[],"description":"<p>审批表单定义</p>\n","children":[{"key":"form_defines.items.condition_groups","name":"condition_groups","deprecated":false,"type":"array[object]","required":"否","enum":[],"xEnum":[],"description":"<p>条件组</p>\n","children":[{"key":"form_defines.items.condition_groups.items.conditions","name":"conditions","deprecated":false,"type":"array[object]","required":"是","enum":[],"xEnum":[],"description":"<p>条件</p>\n","children":[{"key":"form_defines.items.condition_groups.items.conditions.items.custom_data_rule","name":"custom_data_rule","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>json_path,用于用户自定义表单</p>\n","children":[]},{"key":"form_defines.items.condition_groups.items.conditions.items.elem_biz_key","name":"elem_biz_key","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>组件key，用于区分控件组组件</p>\n","children":[]},{"key":"form_defines.items.condition_groups.items.conditions.items.form_id","name":"form_id","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>表单控件id，需要和审批定义里对应</p>\n","children":[]},{"key":"form_defines.items.condition_groups.items.conditions.items.rule","name":"rule","deprecated":false,"type":"string","required":"是","enum":["belongs","not_belongs","contains_any","contains_all","contains_eq","lt","lte","equal","gt","gte"],"xEnum":["belongs","not_belongs","contains_any","contains_all","contains_eq","lt","lte","equal","gt","gte"],"description":"<p>条件规则</p>\n","children":[]},{"key":"form_defines.items.condition_groups.items.conditions.items.type","name":"type","deprecated":false,"type":"string","required":"是","enum":["text_type_input","text_type_area","text_type_file","rich_text","date","select","info","contact","multi_select","number","money","image","sender","date_range"],"xEnum":["text_type_input","text_type_area","text_type_file","rich_text","date","select","info","contact","multi_select","number","money","image","sender","date_range"],"description":"<p>控件类型</p>\n","children":[]},{"key":"form_defines.items.condition_groups.items.conditions.items.value","name":"value","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>条件值，不同的条件类型对应不同的结构体</p>\n","children":[]}]}]},{"key":"form_defines.items.date_range","name":"date_range","deprecated":false,"type":"object","required":"否","enum":[],"xEnum":[],"description":"<p>控件为日期区间时，控件定义</p>\n","children":[{"key":"form_defines.items.date_range.date_range_place","name":"date_range_place","deprecated":false,"type":"string","required":"否","enum":[],"xEnum":[],"description":"<p>日期提示文案</p>\n","children":[]},{"key":"form_defines.items.date_range.duration_title","name":"duration_title","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>时长标题</p>\n","children":[]},{"key":"form_defines.items.date_range.end_time_title","name":"end_time_title","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>结束时间标题</p>\n","children":[]},{"key":"form_defines.items.date_range.start_time_title","name":"start_time_title","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>开始时间标题</p>\n","children":[]},{"key":"form_defines.items.date_range.style","name":"style","deprecated":false,"type":"string","required":"是","enum":["year_month","year_month_day","half_day","hour_minute","hour_minute_timezone"],"xEnum":["year_month","year_month_day","half_day","hour_minute","hour_minute_timezone"],"description":"<p>日期格式</p>\n","children":[]},{"key":"form_defines.items.date_range.time_range","name":"time_range","deprecated":false,"type":"string","required":"是","enum":["all_dates","this_week","this_month","last_seven_days","last_month","last_three_months","last_year"],"xEnum":["all_dates","this_week","this_month","last_seven_days","last_month","last_three_months","last_year"],"description":"<p>可选时间范围类型</p>\n","children":[]}]},{"key":"form_defines.items.extra","name":"extra","deprecated":false,"type":"string","required":"否","enum":[],"xEnum":[],"description":"<p>控件其他选项</p>\n","children":[]},{"key":"form_defines.items.form_options","name":"form_options","deprecated":false,"type":"array[object]","required":"否","enum":[],"xEnum":[],"description":"<p>控件为多选时，选项内容</p>\n","children":[{"key":"form_defines.items.form_options.items.key","name":"key","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>选项key</p>\n","children":[]},{"key":"form_defines.items.form_options.items.value","name":"value","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>选项值</p>\n","children":[]}]},{"key":"form_defines.items.id","name":"id","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>表单控件id，需要业务方自行指定，id不可重复</p>\n","children":[]},{"key":"form_defines.items.placeholder","name":"placeholder","deprecated":false,"type":"string","required":"否","enum":[],"xEnum":[],"description":"<p>控件默认填充内容</p>\n","children":[]},{"key":"form_defines.items.required","name":"required","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>控件内容是否必填，不传默认false</p>\n","children":[]},{"key":"form_defines.items.title","name":"title","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>控件标题</p>\n","children":[]},{"key":"form_defines.items.type","name":"type","deprecated":false,"type":"string","required":"是","enum":["text_type_input","text_type_area","text_type_file","rich_text","date","select","info","contact","multi_select","number","money","image","sender","date_range"],"xEnum":["text_type_input","text_type_area","text_type_file","rich_text","date","select","info","contact","multi_select","number","money","image","sender","date_range"],"description":"<p>控件类型</p>\n","children":[]}]},{"key":"icon","name":"icon","deprecated":false,"type":"string","required":"否","enum":["tmp1","tmp2","tmp3","tmp4","tmp5","tmp6","tmp7","tmp8","tmp9","tmp10","tmp11","tmp12","tmp13","tmp14","tmp15"],"xEnum":["tmp1","tmp2","tmp3","tmp4","tmp5","tmp6","tmp7","tmp8","tmp9","tmp10","tmp11","tmp12","tmp13","tmp14","tmp15"],"description":"<p>审批定义图标，tmp1-tmp15,不传默认tmp15</p>\n","children":[]},{"key":"name","name":"name","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>审批定义名称</p>\n","children":[]},{"key":"process_define","name":"process_define","deprecated":false,"type":"object","required":"是","enum":[],"xEnum":[],"description":"<p>审批流程定义</p>\n","children":[{"key":"process_define.nodes","name":"nodes","deprecated":false,"type":"array[object]","required":"是","enum":[],"xEnum":[],"description":"<p>节点列表</p>\n","children":[{"key":"process_define.nodes.items.child_nodes","name":"child_nodes","deprecated":false,"type":"array[string]","required":"否","enum":[],"xEnum":[],"description":"<p>子节点</p>\n","children":[]},{"key":"process_define.nodes.items.condition_groups","name":"condition_groups","deprecated":false,"type":"array[object]","required":"否","enum":[],"xEnum":[],"description":"<p>条件组</p>\n","children":[]},{"key":"process_define.nodes.items.extra","name":"extra","deprecated":false,"type":"object","required":"否","enum":[],"xEnum":[],"description":"<p>节点扩展信息</p>\n","children":[{"key":"process_define.nodes.items.extra.config","name":"config","deprecated":false,"type":"object","required":"否","enum":[],"xEnum":[],"description":"<p>节点配置</p>\n","children":[{"key":"process_define.nodes.items.extra.config.add_node_forbidden","name":"add_node_forbidden","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>是否禁止添加节点</p>\n","children":[]},{"key":"process_define.nodes.items.extra.config.edit_forbidden","name":"edit_forbidden","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>是否禁止编辑节点</p>\n","children":[]},{"key":"process_define.nodes.items.extra.config.remove_forbidden","name":"remove_forbidden","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>是否禁止删除节点</p>\n","children":[]}]}]},{"key":"process_define.nodes.items.id","name":"id","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>节点编号,同一树下需要唯一</p>\n","children":[]},{"key":"process_define.nodes.items.name","name":"name","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>节点名称</p>\n","children":[]},{"key":"process_define.nodes.items.next_node_id","name":"next_node_id","deprecated":false,"type":"string","required":"否","enum":[],"xEnum":[],"description":"<p>下一个节点</p>\n","children":[]},{"key":"process_define.nodes.items.task","name":"task","deprecated":false,"type":"object","required":"否","enum":[],"xEnum":[],"description":"<p>任务</p>\n","children":[{"key":"process_define.nodes.items.task.task_approve","name":"task_approve","deprecated":false,"type":"object","required":"否","enum":[],"xEnum":[],"description":"<p>审批任务</p>\n","children":[{"key":"process_define.nodes.items.task.task_approve.approval_rule","name":"approval_rule","deprecated":false,"type":"string","required":"否","enum":["step","or_sign","and_sign"],"xEnum":["step","or_sign","and_sign"],"description":"<p>审批规则，只有当审批/抄送用户是多人时赋值</p>\n","children":[]},{"key":"process_define.nodes.items.task.task_approve.select_type","name":"select_type","deprecated":false,"type":"string","required":"否","enum":["single_choice","multi_choice"],"xEnum":["single_choice","multi_choice"],"description":"<p>选择方式，只有当用户类型是发起人自选时赋值</p>\n","children":[]},{"key":"process_define.nodes.items.task.task_approve.target","name":"target","deprecated":false,"type":"object","required":"是","enum":[],"xEnum":[],"description":"<p>审批人员</p>\n","children":[{"key":"process_define.nodes.items.task.task_approve.target.level","name":"level","deprecated":false,"type":"integer","required":"否","enum":[],"xEnum":[],"description":"<p>多级负责人层级,最多9级</p>\n","children":[]},{"key":"process_define.nodes.items.task.task_approve.target.select_ranges","name":"select_ranges","deprecated":false,"type":"array[object]","required":"是","enum":[],"xEnum":[],"description":"<p>人员选择范围</p>\n","children":[{"key":"process_define.nodes.items.task.task_approve.target.select_ranges.items.select_type","name":"select_type","deprecated":false,"type":"string","required":"是","enum":["user","user_group"],"xEnum":["user","user_group"],"description":"<p>选择类型</p>\n","children":[]},{"key":"process_define.nodes.items.task.task_approve.target.select_ranges.items.select_value","name":"select_value","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>可以是user_id/user_group_id</p>\n","children":[]}]},{"key":"process_define.nodes.items.task.task_approve.target.user_group_ids","name":"user_group_ids","deprecated":false,"type":"array[string]","required":"否","enum":[],"xEnum":[],"description":"<p>用户组</p>\n","children":[]},{"key":"process_define.nodes.items.task.task_approve.target.user_ids","name":"user_ids","deprecated":false,"type":"array[string]","required":"否","enum":[],"xEnum":[],"description":"<p>用户id,当type为指定成员时需要传入(如果有限定)</p>\n","children":[]},{"key":"process_define.nodes.items.task.task_approve.target.user_type","name":"user_type","deprecated":false,"type":"string","required":"是","enum":["optional","self","leader","multi_leader","department_owner","multi_department_owner","user_group","assigner"],"xEnum":["optional","self","leader","multi_leader","department_owner","multi_department_owner","user_group","assigner"],"description":"<p>用户类型</p>\n","children":[]}]},{"key":"process_define.nodes.items.task.task_approve.user_empty_policy","name":"user_empty_policy","deprecated":false,"type":"string","required":"否","enum":["transfer_to_admin","auto_pass"],"xEnum":["transfer_to_admin","auto_pass"],"description":"<p>审批人为空时的策略</p>\n","children":[]}]},{"key":"process_define.nodes.items.task.task_cc","name":"task_cc","deprecated":false,"type":"object","required":"否","enum":[],"xEnum":[],"description":"<p>抄送任务</p>\n","children":[{"key":"process_define.nodes.items.task.task_cc.is_allow_add_cc","name":"is_allow_add_cc","deprecated":false,"type":"boolean","required":"是","enum":[],"xEnum":[],"description":"<p>是否允许添加抄送人</p>\n","children":[]},{"key":"process_define.nodes.items.task.task_cc.target","name":"target","deprecated":false,"type":"object","required":"是","enum":[],"xEnum":[],"description":"<p>抄送目标</p>\n","children":[]}]},{"key":"process_define.nodes.items.task.type","name":"type","deprecated":false,"type":"string","required":"是","enum":["approval","cc","custom"],"xEnum":["approval","cc","custom"],"description":"<p>任务类型</p>\n","children":[]}]},{"key":"process_define.nodes.items.type","name":"type","deprecated":false,"type":"string","required":"是","enum":["sequence","select","condition","task"],"xEnum":["sequence","select","condition","task"],"description":"<p>节点类型</p>\n","children":[]}]},{"key":"process_define.root","name":"root","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>根节点序号</p>\n","children":[]}]},{"key":"setting","name":"setting","deprecated":false,"type":"object","required":"否","enum":[],"xEnum":[],"description":"<p>审批定义设置</p>\n","children":[{"key":"setting.allow_revoke_approved_days","name":"allow_revoke_approved_days","deprecated":false,"type":"integer","required":"否","enum":[],"xEnum":[],"description":"<p>允许撤回已通过的审批单期限，单位：天</p>\n","children":[]},{"key":"setting.approval_deduplicate_mode","name":"approval_deduplicate_mode","deprecated":false,"type":"string","required":"否","enum":["none","continuous_node","all_node"],"xEnum":["none","continuous_node","all_node"],"description":"<p>审批人去重规则</p>\n","children":[]},{"key":"setting.approval_share_to_company","name":"approval_share_to_company","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>审批实例是否企业可见</p>\n","children":[]},{"key":"setting.is_allow_resubmit","name":"is_allow_resubmit","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>是否允许重新提交</p>\n","children":[]},{"key":"setting.is_allow_revoke","name":"is_allow_revoke","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>是否允许撤回</p>\n","children":[]},{"key":"setting.is_allow_revoke_approved","name":"is_allow_revoke_approved","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>是否允许撤回已通过的审批单</p>\n","children":[]},{"key":"setting.is_allow_rollback","name":"is_allow_rollback","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>是否允许退回</p>\n","children":[]},{"key":"setting.is_show_in_backend_page","name":"is_show_in_backend_page","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>审批定义是否展示在轻审批管理后台</p>\n","children":[]},{"key":"setting.is_show_in_home_page","name":"is_show_in_home_page","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>审批定义是否展示在轻审批系统前台</p>\n","children":[]},{"key":"setting.must_with_approve_signature","name":"must_with_approve_signature","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>审批实例是否必须填写审批人签名</p>\n","children":[]},{"key":"setting.must_with_refuse_reason","name":"must_with_refuse_reason","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>审批实例是否必须填写拒绝理由</p>\n","children":[]},{"key":"setting.must_with_return_reason","name":"must_with_return_reason","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>审批实例是否必须填写退回理由</p>\n","children":[]},{"key":"setting.one_click_approval","name":"one_click_approval","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>是否允许一键审批</p>\n","children":[]}]},{"key":"visible_scopes","name":"visible_scopes","deprecated":false,"type":"array[object]","required":"否","enum":[],"xEnum":[],"description":"<p>审批定义可见范围</p>\n","children":[{"key":"visible_scopes.items.company_id","name":"company_id","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>可见范围所属公司id</p>\n","children":[]},{"key":"visible_scopes.items.is_admin","name":"is_admin","deprecated":false,"type":"boolean","required":"是","enum":[],"xEnum":[],"description":"<p>是否为管理员,当scope_type为user时有效,默认false</p>\n","children":[]},{"key":"visible_scopes.items.scope_id","name":"scope_id","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>可见范围id，公司id/部门id/用户id</p>\n","children":[]},{"key":"visible_scopes.items.scope_type","name":"scope_type","deprecated":false,"type":"string","required":"是","enum":["company","department","user","user_group"],"xEnum":["company","department","user","user_group"],"description":"<p>可见范围类型</p>\n","children":[]}]}]' />

## 请求体示例
```json
{
  "creator": "string",
  "form_defines": [
    {
      "condition_groups": [
        {
          "conditions": [
            {
              "custom_data_rule": "string",
              "elem_biz_key": "string",
              "form_id": "string",
              "rule": "belongs",
              "type": "text_type_input",
              "value": "string"
            }
          ]
        }
      ],
      "date_range": {
        "date_range_place": "string",
        "duration_title": "string",
        "end_time_title": "string",
        "start_time_title": "string",
        "style": "year_month",
        "time_range": "all_dates"
      },
      "extra": "string",
      "form_options": [
        {
          "key": "string",
          "value": "string"
        }
      ],
      "id": "string",
      "placeholder": "string",
      "required": true,
      "title": "string",
      "type": "text_type_input"
    }
  ],
  "icon": "tmp1",
  "name": "string",
  "process_define": {
    "nodes": [
      {
        "child_nodes": [
          "string"
        ],
        "condition_groups": [
          {}
        ],
        "extra": {
          "config": {
            "add_node_forbidden": true,
            "edit_forbidden": true,
            "remove_forbidden": true
          }
        },
        "id": "string",
        "name": "string",
        "next_node_id": "string",
        "task": {
          "task_approve": {
            "approval_rule": "step",
            "select_type": "single_choice",
            "target": {
              "level": 0,
              "select_ranges": [
                {
                  "select_type": "user",
                  "select_value": "string"
                }
              ],
              "user_group_ids": [
                "string"
              ],
              "user_ids": [
                "string"
              ],
              "user_type": "optional"
            },
            "user_empty_policy": "transfer_to_admin"
          },
          "task_cc": {
            "is_allow_add_cc": true,
            "target": {}
          },
          "type": "approval"
        },
        "type": "sequence"
      }
    ],
    "root": "string"
  },
  "setting": {
    "allow_revoke_approved_days": 0,
    "approval_deduplicate_mode": "none",
    "approval_share_to_company": true,
    "is_allow_resubmit": true,
    "is_allow_revoke": true,
    "is_allow_revoke_approved": true,
    "is_allow_rollback": true,
    "is_show_in_backend_page": true,
    "is_show_in_home_page": true,
    "must_with_approve_signature": true,
    "must_with_refuse_reason": true,
    "must_with_return_reason": true,
    "one_click_approval": true
  },
  "visible_scopes": [
    {
      "company_id": "string",
      "is_admin": true,
      "scope_id": "string",
      "scope_type": "company"
    }
  ]
}
```

## 响应体(Response)
**HTTP状态码:** `200`<br/>
**响应体格式:** `application/json`
<OpenapiRenderTable hideHeaderKeys='required' dataSource='[{"key":"data","name":"data","deprecated":false,"type":"object","required":"是","enum":[],"xEnum":[],"description":"<p>查询审批定义详情结果</p>\n","children":[{"key":"data.created_by","name":"created_by","deprecated":false,"type":"object","required":"是","enum":[],"xEnum":[],"description":"<p>创建者</p>\n","children":[{"key":"data.created_by.avatar","name":"avatar","deprecated":false,"type":"string","required":"否","enum":[],"xEnum":[],"description":"<p>用户或应用的头像</p>\n","children":[]},{"key":"data.created_by.company_id","name":"company_id","deprecated":false,"type":"string","required":"否","enum":[],"xEnum":[],"description":"<p>身份所归属的公司</p>\n","children":[]},{"key":"data.created_by.id","name":"id","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>身份ID</p>\n","children":[]},{"key":"data.created_by.name","name":"name","deprecated":false,"type":"string","required":"否","enum":[],"xEnum":[],"description":"<p>用户或应用的名称</p>\n","children":[]},{"key":"data.created_by.type","name":"type","deprecated":false,"type":"string","required":"是","enum":["user","sp","unknown"],"xEnum":["user","sp","unknown"],"description":"<p>身份类型</p>\n","children":[]}]},{"key":"data.ctime","name":"ctime","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>创建时间，时间戳（ms）</p>\n","children":[]},{"key":"data.form_designs","name":"form_designs","deprecated":false,"type":"array[object]","required":"是","enum":[],"xEnum":[],"description":"<p>审批表单定义</p>\n","children":[{"key":"data.form_designs.items.condition_groups","name":"condition_groups","deprecated":false,"type":"array[object]","required":"否","enum":[],"xEnum":[],"description":"<p>条件组</p>\n","children":[{"key":"data.form_designs.items.condition_groups.items.conditions","name":"conditions","deprecated":false,"type":"array[object]","required":"是","enum":[],"xEnum":[],"description":"<p>条件</p>\n","children":[{"key":"data.form_designs.items.condition_groups.items.conditions.items.custom_data_rule","name":"custom_data_rule","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>json_path,用于用户自定义表单</p>\n","children":[]},{"key":"data.form_designs.items.condition_groups.items.conditions.items.elem_biz_key","name":"elem_biz_key","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>组件key，用于区分控件组组件</p>\n","children":[]},{"key":"data.form_designs.items.condition_groups.items.conditions.items.form_id","name":"form_id","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>表单控件id，需要和审批定义里对应</p>\n","children":[]},{"key":"data.form_designs.items.condition_groups.items.conditions.items.rule","name":"rule","deprecated":false,"type":"string","required":"是","enum":["belongs","not_belongs","contains_any","contains_all","contains_eq","lt","lte","equal","gt","gte"],"xEnum":["belongs","not_belongs","contains_any","contains_all","contains_eq","lt","lte","equal","gt","gte"],"description":"<p>条件规则</p>\n","children":[]},{"key":"data.form_designs.items.condition_groups.items.conditions.items.type","name":"type","deprecated":false,"type":"string","required":"是","enum":["text_type_input","text_type_area","text_type_file","rich_text","date","select","info","contact","multi_select","number","money","image","sender","date_range"],"xEnum":["text_type_input","text_type_area","text_type_file","rich_text","date","select","info","contact","multi_select","number","money","image","sender","date_range"],"description":"<p>控件类型</p>\n","children":[]},{"key":"data.form_designs.items.condition_groups.items.conditions.items.value","name":"value","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>条件值，不同的条件类型对应不同的结构体</p>\n","children":[]}]}]},{"key":"data.form_designs.items.date_range","name":"date_range","deprecated":false,"type":"object","required":"否","enum":[],"xEnum":[],"description":"<p>控件为日期区间时，控件定义</p>\n","children":[{"key":"data.form_designs.items.date_range.date_range_place","name":"date_range_place","deprecated":false,"type":"string","required":"否","enum":[],"xEnum":[],"description":"<p>日期提示文案</p>\n","children":[]},{"key":"data.form_designs.items.date_range.duration_title","name":"duration_title","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>时长标题</p>\n","children":[]},{"key":"data.form_designs.items.date_range.end_time_title","name":"end_time_title","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>结束时间标题</p>\n","children":[]},{"key":"data.form_designs.items.date_range.start_time_title","name":"start_time_title","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>开始时间标题</p>\n","children":[]},{"key":"data.form_designs.items.date_range.style","name":"style","deprecated":false,"type":"string","required":"是","enum":["year_month","year_month_day","half_day","hour_minute","hour_minute_timezone"],"xEnum":["year_month","year_month_day","half_day","hour_minute","hour_minute_timezone"],"description":"<p>日期格式</p>\n","children":[]},{"key":"data.form_designs.items.date_range.time_range","name":"time_range","deprecated":false,"type":"string","required":"是","enum":["all_dates","this_week","this_month","last_seven_days","last_month","last_three_months","last_year"],"xEnum":["all_dates","this_week","this_month","last_seven_days","last_month","last_three_months","last_year"],"description":"<p>可选时间范围类型</p>\n","children":[]}]},{"key":"data.form_designs.items.extra","name":"extra","deprecated":false,"type":"string","required":"否","enum":[],"xEnum":[],"description":"<p>控件其他选项</p>\n","children":[]},{"key":"data.form_designs.items.form_options","name":"form_options","deprecated":false,"type":"array[object]","required":"否","enum":[],"xEnum":[],"description":"<p>控件为多选时，选项内容</p>\n","children":[{"key":"data.form_designs.items.form_options.items.key","name":"key","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>选项key</p>\n","children":[]},{"key":"data.form_designs.items.form_options.items.value","name":"value","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>选项值</p>\n","children":[]}]},{"key":"data.form_designs.items.id","name":"id","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>表单控件id，需要业务方自行指定，id不可重复</p>\n","children":[]},{"key":"data.form_designs.items.placeholder","name":"placeholder","deprecated":false,"type":"string","required":"否","enum":[],"xEnum":[],"description":"<p>控件默认填充内容</p>\n","children":[]},{"key":"data.form_designs.items.required","name":"required","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>控件内容是否必填，不传默认false</p>\n","children":[]},{"key":"data.form_designs.items.title","name":"title","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>控件标题</p>\n","children":[]},{"key":"data.form_designs.items.type","name":"type","deprecated":false,"type":"string","required":"是","enum":["text_type_input","text_type_area","text_type_file","rich_text","date","select","info","contact","multi_select","number","money","image","sender","date_range"],"xEnum":["text_type_input","text_type_area","text_type_file","rich_text","date","select","info","contact","multi_select","number","money","image","sender","date_range"],"description":"<p>控件类型</p>\n","children":[]}]},{"key":"data.group_id","name":"group_id","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>审批定义分组</p>\n","children":[]},{"key":"data.icon","name":"icon","deprecated":false,"type":"string","required":"是","enum":["tmp1","tmp2","tmp3","tmp4","tmp5","tmp6","tmp7","tmp8","tmp9","tmp10","tmp11","tmp12","tmp13","tmp14","tmp15"],"xEnum":["tmp1","tmp2","tmp3","tmp4","tmp5","tmp6","tmp7","tmp8","tmp9","tmp10","tmp11","tmp12","tmp13","tmp14","tmp15"],"description":"<p>审批定义图标</p>\n","children":[]},{"key":"data.id","name":"id","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>审批定义id</p>\n","children":[]},{"key":"data.name","name":"name","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>审批定义名称</p>\n","children":[]},{"key":"data.process_define","name":"process_define","deprecated":false,"type":"object","required":"是","enum":[],"xEnum":[],"description":"<p>审批流程模板</p>\n","children":[{"key":"data.process_define.nodes","name":"nodes","deprecated":false,"type":"array[object]","required":"是","enum":[],"xEnum":[],"description":"<p>节点列表</p>\n","children":[{"key":"data.process_define.nodes.items.child_nodes","name":"child_nodes","deprecated":false,"type":"array[string]","required":"否","enum":[],"xEnum":[],"description":"<p>子节点</p>\n","children":[]},{"key":"data.process_define.nodes.items.condition_groups","name":"condition_groups","deprecated":false,"type":"array[object]","required":"否","enum":[],"xEnum":[],"description":"<p>条件组</p>\n","children":[]},{"key":"data.process_define.nodes.items.extra","name":"extra","deprecated":false,"type":"object","required":"否","enum":[],"xEnum":[],"description":"<p>节点扩展信息</p>\n","children":[{"key":"data.process_define.nodes.items.extra.config","name":"config","deprecated":false,"type":"object","required":"否","enum":[],"xEnum":[],"description":"<p>节点配置</p>\n","children":[{"key":"data.process_define.nodes.items.extra.config.add_node_forbidden","name":"add_node_forbidden","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>是否禁止添加节点</p>\n","children":[]},{"key":"data.process_define.nodes.items.extra.config.edit_forbidden","name":"edit_forbidden","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>是否禁止编辑节点</p>\n","children":[]},{"key":"data.process_define.nodes.items.extra.config.remove_forbidden","name":"remove_forbidden","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>是否禁止删除节点</p>\n","children":[]}]}]},{"key":"data.process_define.nodes.items.id","name":"id","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>节点编号,同一树下需要唯一</p>\n","children":[]},{"key":"data.process_define.nodes.items.name","name":"name","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>节点名称</p>\n","children":[]},{"key":"data.process_define.nodes.items.next_node_id","name":"next_node_id","deprecated":false,"type":"string","required":"否","enum":[],"xEnum":[],"description":"<p>下一个节点</p>\n","children":[]},{"key":"data.process_define.nodes.items.task","name":"task","deprecated":false,"type":"object","required":"否","enum":[],"xEnum":[],"description":"<p>任务</p>\n","children":[{"key":"data.process_define.nodes.items.task.task_approve","name":"task_approve","deprecated":false,"type":"object","required":"否","enum":[],"xEnum":[],"description":"<p>审批任务</p>\n","children":[{"key":"data.process_define.nodes.items.task.task_approve.approval_rule","name":"approval_rule","deprecated":false,"type":"string","required":"否","enum":["step","or_sign","and_sign"],"xEnum":["step","or_sign","and_sign"],"description":"<p>审批规则，只有当审批/抄送用户是多人时赋值</p>\n","children":[]},{"key":"data.process_define.nodes.items.task.task_approve.select_type","name":"select_type","deprecated":false,"type":"string","required":"否","enum":["single_choice","multi_choice"],"xEnum":["single_choice","multi_choice"],"description":"<p>选择方式，只有当用户类型是发起人自选时赋值</p>\n","children":[]},{"key":"data.process_define.nodes.items.task.task_approve.target","name":"target","deprecated":false,"type":"object","required":"是","enum":[],"xEnum":[],"description":"<p>审批人员</p>\n","children":[{"key":"data.process_define.nodes.items.task.task_approve.target.level","name":"level","deprecated":false,"type":"integer","required":"否","enum":[],"xEnum":[],"description":"<p>多级负责人层级,最多9级</p>\n","children":[]},{"key":"data.process_define.nodes.items.task.task_approve.target.select_ranges","name":"select_ranges","deprecated":false,"type":"array[object]","required":"是","enum":[],"xEnum":[],"description":"<p>人员选择范围</p>\n","children":[{"key":"data.process_define.nodes.items.task.task_approve.target.select_ranges.items.select_type","name":"select_type","deprecated":false,"type":"string","required":"是","enum":["user","user_group"],"xEnum":["user","user_group"],"description":"<p>选择类型</p>\n","children":[]},{"key":"data.process_define.nodes.items.task.task_approve.target.select_ranges.items.select_value","name":"select_value","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>可以是user_id/user_group_id</p>\n","children":[]}]},{"key":"data.process_define.nodes.items.task.task_approve.target.user_group_ids","name":"user_group_ids","deprecated":false,"type":"array[string]","required":"否","enum":[],"xEnum":[],"description":"<p>用户组</p>\n","children":[]},{"key":"data.process_define.nodes.items.task.task_approve.target.user_ids","name":"user_ids","deprecated":false,"type":"array[string]","required":"否","enum":[],"xEnum":[],"description":"<p>用户id,当type为指定成员时需要传入(如果有限定)</p>\n","children":[]},{"key":"data.process_define.nodes.items.task.task_approve.target.user_type","name":"user_type","deprecated":false,"type":"string","required":"是","enum":["optional","self","leader","multi_leader","department_owner","multi_department_owner","user_group","assigner"],"xEnum":["optional","self","leader","multi_leader","department_owner","multi_department_owner","user_group","assigner"],"description":"<p>用户类型</p>\n","children":[]}]},{"key":"data.process_define.nodes.items.task.task_approve.user_empty_policy","name":"user_empty_policy","deprecated":false,"type":"string","required":"否","enum":["transfer_to_admin","auto_pass"],"xEnum":["transfer_to_admin","auto_pass"],"description":"<p>审批人为空时的策略</p>\n","children":[]}]},{"key":"data.process_define.nodes.items.task.task_cc","name":"task_cc","deprecated":false,"type":"object","required":"否","enum":[],"xEnum":[],"description":"<p>抄送任务</p>\n","children":[{"key":"data.process_define.nodes.items.task.task_cc.is_allow_add_cc","name":"is_allow_add_cc","deprecated":false,"type":"boolean","required":"是","enum":[],"xEnum":[],"description":"<p>是否允许添加抄送人</p>\n","children":[]},{"key":"data.process_define.nodes.items.task.task_cc.target","name":"target","deprecated":false,"type":"object","required":"是","enum":[],"xEnum":[],"description":"<p>抄送目标</p>\n","children":[]}]},{"key":"data.process_define.nodes.items.task.type","name":"type","deprecated":false,"type":"string","required":"是","enum":["approval","cc","custom"],"xEnum":["approval","cc","custom"],"description":"<p>任务类型</p>\n","children":[]}]},{"key":"data.process_define.nodes.items.type","name":"type","deprecated":false,"type":"string","required":"是","enum":["sequence","select","condition","task"],"xEnum":["sequence","select","condition","task"],"description":"<p>节点类型</p>\n","children":[]}]},{"key":"data.process_define.root","name":"root","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>根节点序号</p>\n","children":[]}]},{"key":"data.setting","name":"setting","deprecated":false,"type":"object","required":"是","enum":[],"xEnum":[],"description":"<p>审批定义设置</p>\n","children":[{"key":"data.setting.allow_revoke_approved_days","name":"allow_revoke_approved_days","deprecated":false,"type":"integer","required":"否","enum":[],"xEnum":[],"description":"<p>允许撤回已通过的审批单期限，单位：天</p>\n","children":[]},{"key":"data.setting.approval_deduplicate_mode","name":"approval_deduplicate_mode","deprecated":false,"type":"string","required":"否","enum":["none","continuous_node","all_node"],"xEnum":["none","continuous_node","all_node"],"description":"<p>审批人去重规则</p>\n","children":[]},{"key":"data.setting.approval_share_to_company","name":"approval_share_to_company","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>审批实例是否企业可见</p>\n","children":[]},{"key":"data.setting.is_allow_resubmit","name":"is_allow_resubmit","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>是否允许重新提交</p>\n","children":[]},{"key":"data.setting.is_allow_revoke","name":"is_allow_revoke","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>是否允许撤回</p>\n","children":[]},{"key":"data.setting.is_allow_revoke_approved","name":"is_allow_revoke_approved","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>是否允许撤回已通过的审批单</p>\n","children":[]},{"key":"data.setting.is_allow_rollback","name":"is_allow_rollback","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>是否允许退回</p>\n","children":[]},{"key":"data.setting.is_show_in_backend_page","name":"is_show_in_backend_page","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>审批定义是否展示在轻审批管理后台</p>\n","children":[]},{"key":"data.setting.is_show_in_home_page","name":"is_show_in_home_page","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>审批定义是否展示在轻审批系统前台</p>\n","children":[]},{"key":"data.setting.must_with_approve_signature","name":"must_with_approve_signature","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>审批实例是否必须填写审批人签名</p>\n","children":[]},{"key":"data.setting.must_with_refuse_reason","name":"must_with_refuse_reason","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>审批实例是否必须填写拒绝理由</p>\n","children":[]},{"key":"data.setting.must_with_return_reason","name":"must_with_return_reason","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>审批实例是否必须填写退回理由</p>\n","children":[]},{"key":"data.setting.one_click_approval","name":"one_click_approval","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>是否允许一键审批</p>\n","children":[]}]},{"key":"data.visible_scopes","name":"visible_scopes","deprecated":false,"type":"array[object]","required":"否","enum":[],"xEnum":[],"description":"<p>审批定义可见范围</p>\n","children":[{"key":"data.visible_scopes.items.company_id","name":"company_id","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>可见范围所属公司id</p>\n","children":[]},{"key":"data.visible_scopes.items.is_admin","name":"is_admin","deprecated":false,"type":"boolean","required":"是","enum":[],"xEnum":[],"description":"<p>是否为管理员,当scope_type为user时有效,默认false</p>\n","children":[]},{"key":"data.visible_scopes.items.scope_id","name":"scope_id","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>可见范围id，公司id/部门id/用户id</p>\n","children":[]},{"key":"data.visible_scopes.items.scope_type","name":"scope_type","deprecated":false,"type":"string","required":"是","enum":["company","department","user","user_group"],"xEnum":["company","department","user","user_group"],"description":"<p>可见范围类型</p>\n","children":[]}]}]},{"key":"code","name":"code","deprecated":false,"type":"integer","required":"是","enum":[],"xEnum":[],"description":"-","children":[]},{"key":"msg","name":"msg","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>人可阅读的文本信息，可能会按不同的语言或地区返回不同的文本信息。</p>\n","children":[]}]' />

## 响应体示例
```json
{
  "data": {
    "created_by": {
      "avatar": "string",
      "company_id": "string",
      "id": "string",
      "name": "string",
      "type": "user"
    },
    "ctime": "string",
    "form_designs": [
      {
        "condition_groups": [
          {
            "conditions": [
              {
                "custom_data_rule": "string",
                "elem_biz_key": "string",
                "form_id": "string",
                "rule": "belongs",
                "type": "text_type_input",
                "value": "string"
              }
            ]
          }
        ],
        "date_range": {
          "date_range_place": "string",
          "duration_title": "string",
          "end_time_title": "string",
          "start_time_title": "string",
          "style": "year_month",
          "time_range": "all_dates"
        },
        "extra": "string",
        "form_options": [
          {
            "key": "string",
            "value": "string"
          }
        ],
        "id": "string",
        "placeholder": "string",
        "required": true,
        "title": "string",
        "type": "text_type_input"
      }
    ],
    "group_id": "string",
    "icon": "tmp1",
    "id": "string",
    "name": "string",
    "process_define": {
      "nodes": [
        {
          "child_nodes": [
            "string"
          ],
          "condition_groups": [
            {}
          ],
          "extra": {
            "config": {
              "add_node_forbidden": true,
              "edit_forbidden": true,
              "remove_forbidden": true
            }
          },
          "id": "string",
          "name": "string",
          "next_node_id": "string",
          "task": {
            "task_approve": {
              "approval_rule": "step",
              "select_type": "single_choice",
              "target": {
                "level": 0,
                "select_ranges": [
                  {
                    "select_type": "user",
                    "select_value": "string"
                  }
                ],
                "user_group_ids": [
                  "string"
                ],
                "user_ids": [
                  "string"
                ],
                "user_type": "optional"
              },
              "user_empty_policy": "transfer_to_admin"
            },
            "task_cc": {
              "is_allow_add_cc": true,
              "target": {}
            },
            "type": "approval"
          },
          "type": "sequence"
        }
      ],
      "root": "string"
    },
    "setting": {
      "allow_revoke_approved_days": 0,
      "approval_deduplicate_mode": "none",
      "approval_share_to_company": true,
      "is_allow_resubmit": true,
      "is_allow_revoke": true,
      "is_allow_revoke_approved": true,
      "is_allow_rollback": true,
      "is_show_in_backend_page": true,
      "is_show_in_home_page": true,
      "must_with_approve_signature": true,
      "must_with_refuse_reason": true,
      "must_with_return_reason": true,
      "one_click_approval": true
    },
    "visible_scopes": [
      {
        "company_id": "string",
        "is_admin": true,
        "scope_id": "string",
        "scope_type": "company"
      }
    ]
  },
  "code": 0,
  "msg": "string"
}
```