开发者社区 问答 正文

钉钉actioncard怎么展示流程数据呢?

钉钉actioncard怎么展示流程数据呢?

展开
收起
真的很搞笑 2024-03-12 21:04:49 68 分享 版权
阿里云 AI 助理回答

在钉钉中使用 actionCard 类型的消息展示流程数据,可以通过配置消息模板来实现。以下是详细的步骤和配置说明:


1. 配置 actionCard 消息类型

actionCard 是钉钉支持的一种消息类型,适合用于展示带有操作按钮的卡片式内容。它可以通过以下两种方式展示流程数据: - 整体跳转:点击卡片后跳转到一个统一的页面。 - 独立跳转:为每个按钮设置不同的跳转链接。


2. 整体跳转 actionCard 示例

如果需要通过点击卡片跳转到一个统一的页面(如流程详情页),可以使用整体跳转的 actionCard 配置:

{
  "msgtype": "actionCard",
  "actionCard": {
    "title": "流程数据概览",
    "text": "![流程图](image_url) \n ### 当前流程状态:进行中 \n 流程名称:审批流程A \n 发起人:张三 \n 启动时间:2023-10-01",
    "btnOrientation": "0",
    "singleTitle": "查看详情",
    "singleURL": "https://example.com/process_detail"
  }
}

参数说明:

  • title:消息预览框标题,建议简明扼要地描述流程主题。
  • text:消息内容,支持 Markdown 格式,可嵌入图片、文字等信息。
  • btnOrientation:按钮排列方向,0 表示垂直排列,1 表示横向排列。
  • singleTitle:按钮标题,用户点击后触发跳转。
  • singleURL:跳转的目标 URL,需替换为实际的流程详情页面地址。

3. 独立跳转 actionCard 示例

如果需要为每个按钮设置不同的跳转链接(如查看流程详情、审批操作等),可以使用独立跳转的 actionCard 配置:

{
  "msgtype": "actionCard",
  "actionCard": {
    "title": "流程数据概览",
    "text": "![流程图](image_url) \n ### 当前流程状态:待审批 \n 流程名称:审批流程B \n 发起人:李四 \n 启动时间:2023-10-02",
    "btnOrientation": "1",
    "btns": [
      {
        "title": "查看详情",
        "actionURL": "https://example.com/process_detail"
      },
      {
        "title": "一键通过",
        "actionURL": "https://example.com/approve_pass"
      },
      {
        "title": "拒绝审批",
        "actionURL": "https://example.com/approve_reject"
      }
    ]
  }
}

参数说明:

  • btns:按钮列表,每个按钮包含 titleactionURL
    • title:按钮显示的文字。
    • actionURL:按钮点击后跳转的目标 URL。

4. 动态数据绑定

为了动态展示流程数据,可以结合变量替换功能。例如,使用 ${processName}${status} 等占位符动态填充流程名称、状态等信息:

{
  "msgtype": "actionCard",
  "actionCard": {
    "title": "${processName}",
    "text": "![流程图](image_url) \n ### 当前流程状态:${status} \n 发起人:${initiator} \n 启动时间:${startTime}",
    "btnOrientation": "0",
    "singleTitle": "查看详情",
    "singleURL": "${detailUrl}"
  }
}

动态参数说明:

  • ${processName}:流程名称。
  • ${status}:流程当前状态(如“进行中”、“待审批”)。
  • ${initiator}:流程发起人。
  • ${startTime}:流程启动时间。
  • ${detailUrl}:流程详情页面的动态链接。

5. 注意事项

  • 图片链接![流程图](image_url) 中的 image_url 需替换为实际的图片地址,确保图片能够正常加载。
  • 权限控制:确保跳转链接的目标页面有适当的权限校验,避免未授权访问。
  • API 调用限制:如果通过 API 发送消息,请注意钉钉的 API 调用频率限制,超出限制可能导致消息发送失败。

通过以上配置,您可以灵活地使用钉钉 actionCard 消息类型展示流程数据,并根据业务需求选择整体跳转或独立跳转的方式。

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