钉钉 卡片平台开放的卡片如何调用另一个卡片？

在钉钉卡片平台中，调用另一个卡片的功能通常通过互动卡片或卡片跳转的方式实现。以下是具体的操作步骤和方法：

1. 通过互动卡片调用另一个卡片

互动卡片允许用户在一个卡片中触发事件（如按钮点击），从而动态更新卡片内容或跳转到另一个卡片。

实现步骤：

1. 创建目标卡片模板
   在钉钉卡片平台中，为目标卡片创建一个模板，并获取其模板ID。

2. 配置源卡片的互动事件

   • 在源卡片模板中，添加一个按钮组件或其他可交互组件。
   • 配置该组件的回调事件，例如onClick事件。
   • 在回调事件中，指定目标卡片的模板ID，并传递必要的参数（如数据上下文）。

3. 后端处理逻辑

   • 当用户与源卡片交互时，钉钉会向您的后端服务发送事件通知。
   • 后端服务根据事件内容，生成目标卡片的数据并返回给钉钉客户端。
   • 钉钉客户端将动态渲染目标卡片。

注意事项：

• 权限配置：确保应用已申请Card.Instance.Write和Card.Streaming.Write权限。
• 流式更新支持：如果需要实时更新卡片内容，请启用Stream模式推送。

2. 通过卡片跳转调用另一个卡片

卡片跳转是一种更直接的方式，允许用户从一个卡片跳转到另一个卡片或仪表板。

实现步骤：

1. 配置跳转链接

   • 在源卡片中，添加一个跳转链接（如按钮或超链接）。
   • 设置跳转链接的目标地址为https://dms.aliyun.com或其他指定的卡片页面地址。
   • 如果目标卡片需要携带参数，可以通过URL参数传递。

2. 目标卡片接收参数

   • 目标卡片需要能够解析URL中的参数，并根据参数动态加载数据。
   • 确保目标卡片的查询条件与传递的参数一致。

示例场景：

• 用户在源卡片中点击“查看详情”按钮，跳转到目标卡片查看详细数据。
• 跳转链接示例：https://dms.aliyun.com?cardId=12345&region=华东

3. 通过Quick BI卡片看板集成

如果您使用的是Quick BI的卡片看板功能，可以通过以下方式实现卡片间的调用：

1. 收藏卡片到看板

   • 在Quick BI中，将多个卡片添加到同一个卡片看板中。
   • 卡片看板支持拖动调整布局，并自动适配样式。

2. 卡片间联动

   • 在卡片看板中，设置卡片之间的联动关系。
   • 例如，点击某个卡片中的数据点，可以触发其他卡片的数据刷新或过滤。

3. 分享与跳转

   • 支持将单个卡片或整个看板分享到钉钉、企业微信等平台。
   • 分享链接中可以包含自定义文案和跳转目标。

4. 重要提醒

• 权限管理：无论是互动卡片还是跳转卡片，都需要确保应用具备相应的权限，例如Card.Instance.Write和Card.Streaming.Write。
• 数据一致性：在卡片间传递参数时，确保数据格式和字段名称一致，避免因参数错误导致跳转失败。
• 用户体验优化：建议在卡片设计中加入明确的引导信息（如按钮文字或提示文案），提升用户的操作体验。

通过上述方法，您可以在钉钉卡片平台中实现卡片间的调用和联动，满足不同场景下的需求。