开发者社区> 问答> 正文

钉钉如何使用「创建或更新审批表单模板」接口?

钉钉如何使用「创建或更新审批表单模板」接口?

展开
收起
冰激凌甜筒 2023-07-12 17:15:42 148 0
3 条回答
写回答
取消 提交回答
  • 要使用钉钉的「创建或更新审批表单模板」接口,您可以按照以下步骤进行操作:

    1. 获取 Access Token:首先,您需要获取到有效的 Access Token。Access Token是访问钉钉开放平台接口的凭证,可以通过企业自建应用的身份验证来获取。

    2. 构建请求参数:根据接口文档中的要求,构建一个包含必要参数的 JSON 对象。例如,请求参数可能包括模板名称、字段列表、控件类型等。确保提供有效的信息以便创建或更新审批表单模板。

    3. 发起 API 请求:使用 HTTP POST 请求方法,将构建好的请求参数作为请求体(body)发送给「创建或更新审批表单模板」接口。接口 URL 格式为 https://oapi.dingtalk.com/topapi/process/save

    4. 处理响应结果:根据 API 的响应结果,您可以判断是否成功创建或更新了审批表单模板。通常,成功的响应会返回一个模板 ID 或其他相关信息。

    2023-07-12 23:41:47
    赞同 展开评论 打赏
  • 北京阿里云ACE会长

    使用此接口需要 knowing 以下信息:

    access_token:钉钉Access Token,用于授权

    form_definition:表单定义

    这是一个JSON对象,用来定义表单的信息,包括:

    template_name:模板名称
    form_data:表单字段列表
    approval_flow_id:关联的流程ID
    ...其他相关信息
    template_id:模板ID(更新时需要)
    更新表单模板时需要传入其模板ID。创建时会由接口返回。

    具体调用方式为:

    Copy
    POST /oa/form/template/sys
    请求Header:

    Copy
    {
    "AccessToken": "your_access_token",
    "Content-Type": "application/json"
    }
    请求Body 为 form_definition 对象。

    接口返回的JSON Body 中会包含:

    template_id:新创建的模板ID
    form_definition:完整的表单定义
    error_code:错误码

    2023-07-12 19:06:28
    赞同 展开评论 打赏
  • 调用「创建或更新审批表单模板」接口需要以下权限之一:企业内部应用的工作流模板写权限或第三方企业应用的工作流模板写权限。该接口请求方法为POST,请求路径为/v1.0/workflow/forms,请求头需要包含x-acs-dingtalk-access-token。请求体需要包含processCode、name、description、formComponents和templateConfig等参数,其中formComponents为表单组件数组,templateConfig为表单配置参数,此回答整理自钉群"钉钉开发者社区(互助群)"

    2023-07-12 19:06:30
    赞同 展开评论 打赏
来源圈子
更多
收录在圈子:
+ 订阅
问答排行榜
最热
最新

相关电子书

更多
钉钉小程序——为工作方式插上翅膀 立即下载
钉钉客户端自动化的应用 立即下载
使命必达 —— 钉钉企业级 消息服务的机遇与挑战 立即下载