开发者社区 问答 正文

钉钉获取审批单流程中的节点信息 这个有人用过吗?

钉钉获取审批单流程中的节点信息 这个有人用过吗?

展开
收起
真的很搞笑 2024-04-02 17:09:24 63 分享 版权
阿里云 AI 助理回答

在钉钉中获取审批单流程中的节点信息,通常需要结合阿里云相关产品的API或功能配置来实现。以下是基于知识库资料的详细解答:


1. 钉钉与审批流程的集成

钉钉支持通过消息通知的方式接收审批任务,并允许用户在移动端进行审批操作。要获取审批单流程中的节点信息,可以通过以下方式实现: - 普通钉钉、专属钉钉和飞书消息通知:支持审批任务的通知和审批操作。 - 邮件通知:仅支持通知,不支持直接审批。

重要提醒
- 钉钉消息通知需要正确配置安全设置,确保在钉钉机器人管理中勾选自定义关键词并添加关键词DataWorks,同时不要勾选其他安全设置选项,否则可能导致无法正常接收审批通知。


2. 获取审批节点信息的API方法

如果需要通过API获取审批单流程中的节点信息,可以使用以下接口:

(1) ListWorkFlowNodes - 获取审批节点列表

此接口用于列出审批流程中的所有节点信息,适用于系统角色为管理员或DBA的用户。

请求参数: | 参数名 | 类型 | 是否必填 | 描述 | |-------------|--------|----------|----------------------------------------------------------------------| | Tid | long | 否 | 租户ID,可通过系统右上角头像处悬停展示的租户ID获取。 | | SearchName | string | 否 | 搜索审批节点名称,用于筛选特定节点。 |

返回参数: | 参数名 | 类型 | 描述 | |-------------------|---------------|----------------------------------------------------------------------| | WorkflowNodes | array | 审批节点信息列表。 | | NodeName | string | 节点名称。 | | NodeType | string | 节点类型,取值包括SYS(系统定义)和USER_LIST(用户自定义)。 | | AuditUsers | array | 审批人信息,包括审批人的真实姓名、昵称和用户ID。 |

示例

{
  "WorkflowNodes": [
    {
      "NodeName": "DBA",
      "NodeType": "SYS",
      "AuditUsers": [
        {
          "RealName": "张三",
          "NickName": "zhangsan",
          "UserId": 12345
        }
      ]
    }
  ]
}

(2) GetApprovalDetail - 获取工单审批详情

此接口用于获取指定工单的审批流程详情,包括每个节点的状态和操作记录。

请求参数: | 参数名 | 类型 | 是否必填 | 描述 | |--------------------|--------|----------|----------------------------------------------------------------------| | Tid | long | 否 | 租户ID,可通过调用GetUserActiveTenant接口获取。 | | WorkflowInstanceId | long | 是 | 审批流ID,可通过调用GetOrderBaseInfo接口获取。 |

返回参数: | 参数名 | 类型 | 描述 | |--------------------|---------------|----------------------------------------------------------------------| | WorkflowNodes | array | 审批流程节点信息列表。 | | NodeName | string | 审批节点名称。 | | AuditUserIdList | array | 审批工单的用户ID列表。 | | OperateComment | string | 审批操作备注,例如“同意”或“拒绝”。 | | WorkflowInsCode | string | 工单审批状态,取值包括START(初始状态)、AUDITING(审批中)、APPROVED(已批准)等。 |

示例

{
  "WorkflowNodes": [
    {
      "NodeName": "DBA",
      "AuditUserIdList": [12345],
      "OperateComment": "理由:同意",
      "WorkflowInsCode": "APPROVED"
    }
  ]
}

3. 配置审批节点的注意事项

在配置审批节点时,需关注以下几点: - 审批流程定义:审批流程会按照已定义的审批节点从上至下流转,只有当前节点审批通过后,下一个节点才会收到通知。 - 审批人员定义:每个节点可以选择不同的审批人类型,包括DataWorks空间角色DataWorks空间成员表责任人阿里云主账号MaxComputeRole。 - 多审批人处理:当一个节点包含多个审批人时,通知会发送给所有人员,但只需其中任意一人完成审批即可。


4. 实际应用场景

如果您已经在钉钉中集成了审批流程,可以通过以下步骤验证节点信息的获取: 1. 确保钉钉机器人已正确配置安全设置,添加关键词DataWorks。 2. 使用ListWorkFlowNodes接口获取审批节点列表,确认节点名称和审批人信息。 3. 使用GetApprovalDetail接口查看具体工单的审批流程状态和操作记录。


总结

通过上述API和配置方法,您可以成功获取审批单流程中的节点信息,并在钉钉中实现审批任务的通知和操作。如果有进一步的需求或问题,请提供更多具体场景以便更精准地解答。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答