创建订阅任务

更新时间:
复制为 MD 格式

Quick BI订阅推送功能可以将报表以截图或附件的方式发送给用户,并可以设置订阅任务的发送周期和接收方式。本文将为您介绍如何创建订阅任务,并通过邮件、钉钉/企业微信/飞书、自定义渠道等方式推送订阅任务。

限制说明

  • 仅高级版和专业版支持使用订阅推送功能。

  • 仅专业版支持以下功能:

    • 按“接收人”创建订阅任务,每个组织最多支持创建10个该类型订阅任务,每个任务支持的最大权限组合数为30个。

    • 开启图表数据为空处理功能,减少无效内容的推送。

操作步骤

您可以在订阅管理页面中新建订阅任务,支持按照订阅任务负责人接收人的数据权限创建任务。

  • 当按任务负责人权限创建任务时,系统将统一使用负责人的数据权限查询并生成订阅内容,此时所有接收人收到的内容一致。

  • 当按任务接收人权限创建任务时,系统将为每位接收人基于其个人数据权限单独查询、生成并推送差异化内容,实现“千人千面”的推送效果。

不同任务类型的配置说明如下。

按任务负责人权限创建

  1. 登录Quick BI控制台,点击顶部导航栏的企业应用图标(image)并选择订阅管理

    image

  2. 订阅管理页面的订阅任务页签下,单击+ 新建订阅任务

    image

  3. 新建任务弹窗中,配置以下内容。image

    名称

    描述

    订阅任务名称

    设置订阅任务的名称,方便管理。例如,自定义订阅任务名称为财务部经营日报

    订阅任务标题

    设置订阅任务的标题,即邮件或钉钉等消息的标题。

    标题后缀

    设置在订阅任务的主题上是否显示时间。

    支持时间的粒度为月、日、小时。此处的时间为相对时间,示例如下。image.png

    开头

    订阅任务正文的开头部分,位于嵌入订阅任务中的报表的前面。

    支持设置文本的字号、加粗、倾斜、下划线、字体颜色、背景颜色、对齐方式和行间距,并支持插入链接。image.png

    说明

    企业微信渠道不支持设置倾斜。

    内容

    配置当前订阅任务中需要推送的数据内容,支持选择仪表板电子表格Q报告

    • 当选中仪表板时,您需要配置工作空间、嵌入订阅的具体仪表板及订阅的内容范围。image

      支持订阅仪表板内全部内容部分内容,实现组件级别订阅。

      • 全部内容:选择全部内容时,默认选择仪表板内全部组件。

      • 部分内容:选择部分内容时,支持选择多个组件,包括图表组件仪表板解读组件

        说明

        最多支持选择50个组件。

        image

        • 图表组件

          支持选择画布上或Tab内的图表,勾选Tab可实现对Tab内所有图表的全选。

          134

        • 仪表板解读组件

          支持勾选仪表板解读组件。

          image

          具体请参见仪表板解读组件

        • 应用查询控件

          您可以单击右侧image图标,根据实际需要开启应用查询控件

          image

          说明

          开启后,将应用与图表关联的查询控件,确保截图与仪表板一致。

          关闭后,仅保留图表绑定的查询参数。

    • 当选中电子表格时,您需要配置工作空间、嵌入订阅的具体电子表格。

      image

      支持订阅电子表格内全部内容部分内容,实现Sheet级别订阅。

      • 全部内容:选择全部内容时,默认选择电子表格内全部组件。

      • 部分内容:选择部分内容时,支持选择多个Sheet页。

        说明
        • 最多支持选择50Sheet页。

        • 旧版电子表格不支持订阅部分内容。请先对该电子表格进行编辑,以升级至新版本,然后再进行订阅。

        image

    • 当选中Q报告时,在可选报告列表中展示了当前组织内您拥有查看权限的报告,您可以按需选择。image

    说明

    支持用全局参数来动态控制订阅的结果,仪表板及电子表格的全局参数配置方法请参见配置全局参数;小Q报告的全局参数配置方式请参见全局参数image.png

    结尾

    正文的结尾部分,位于嵌入订阅任务中的报表的后面。

    支持设置文本的字号、加粗、倾斜、下划线、字体颜色、背景颜色、对齐方式和行间距,并支持插入链接。

    image.png

    说明

    企业微信渠道不支持设置倾斜。

    负责人

    默认显示为该订阅任务的创建者,若您想要更换负责人,可以在订阅任务列表中,转交负责人,详细操作请参见转让负责人

    数据权限

    设置订阅任务的数据权限为任务负责人

    此时系统将根据订阅任务负责人的数据权限,对订阅内容进行查询截图,因此订阅内容接收人收到的将是一样的数据内容,均来自任务负责人的数据权限视图。

    发送内容

    支持选择截图报表链接数据附件三种类型。

    说明
    • 仅当接收方式邮件,报表支持下载附件,且用户拥有该仪表板或电子表格的导出权限时,才支持发送数据附件

    • 当小Q报告订阅任务中选择了报表链接时,请确保订阅消息接收人拥有该报告的查看权限,否则将无法正常打开报告。

    截图类型

    发送内容截图发送时,可以设置截图的格式为JPEGPNG,并支持选择1倍或2倍的像素比。

    image.png

    附件类型

    接收到的数据附件类型,当内容为仪表板、电子表格时支持选择ExcelPDF类型;当内容为小Q报告时支持选择PDFWord类型。

    说明

    仅当发送内容中勾选了数据附件时,才会出现该选项。

    Excel内容、数据格式

    当附件类型中勾选了Excel时,您可以进行以下配置。

    • Excel内容:当订阅的内容仪表板时,您可以选择将该仪表板的全部内容作为数据附件,也可以选择将仪表板中的某一图表作为数据附件。image

    • 数据格式:设置Excel附件的内容为带格式导出,纯数据

      • 选择带格式导出时,Excel附件中将携带交叉表、明细表中的数据格式及样式。

        说明

        目前仅交叉表、明细表支持携带数据格式及样式导出。如果您需要订阅的仪表板中不包含以上图表类型,将无法设置数据格式。

      • 选择纯数据时,Excel附件中将仅包含纯文本数据。

    页面方向

    附件类型中勾选了PDF时,支持设置PDF中的页面方向纵向横向

    当电子表格或仪表板图表数据中行较多时,建议使用纵向截图;当列较多时,建议使用横向截图。

    image.png

    报表宽度

    图像的分辨率。

    • 当嵌入的内容为仪表板时,PC端默认宽度为1920像素,移动端默认宽度为375像素。

    • 当嵌入的内容为电子表格时,PC端默认宽度为1920像素,您可以根据电子表格的数据列自定义移动端的图像分辨率。

    显示水印

    开启后,订阅截图和附件中将显示任务创建者水印,请确保已开启报表中的水印开关。

    触发方式

    选择订阅任务的触发方式,支持设置为定时触发、URL触发。

    • 定时:在指定的时间推送订阅任务,例如:每日16:35。image

    • URL触发:系统将为当前订阅任务生成一个专属的触发URL(即webhook地址),您可以通过访问该地址触发订阅任务。

    订阅任务信息配置完成后点击确定按钮,创建成功后即可于配置URL触发弹窗中获取当前订阅任务的触发地址。后续您还可以在订阅管理页面的触发方式栏中复制此地址,具体操作请参见获取URL触发地址image

    获取地址后,您可以将其集成至各类外部系统或自动化流程中,通过访问该URL立即触发订阅任务。

    数据为空处理

    当订阅内容为仪表板且触发方式为定时,则可在此配置图表数据为空时系统的处理方式,从而减少无效内容的推送。

    点击开关(image)开启数据为空处理流程,并通过点击设置图标(image)在弹窗中进一步配置具体处理规则。

    image

    开启后,若图表数据为空系统将拦截推送,并以 30 分钟为间隔进行重试。重试次数视推送周期而定,最多重试4次。若重试后数据仍为空,则订阅任务失败,订阅任务创建者将会收到通知。

    说明

    以下仪表板组件的内容不参与判断是否为空:

    • 查询控件

    • 富文本

    • Q解读组件

    • 故事线

    • 图表组件的备注/尾注

    接收方式

    支持邮件、钉钉通知、飞书通知、企业微信通知、自定义渠道5种方式,并且钉钉/飞书/企业微信推送方式支持选择个人群组

    image.png

    说明

    高级版仅支持邮件方式。

    收件人接收群

    接收方式为邮箱。

    • 一次可选择多个收件人,且收件人只能是同组织下的阿里云账户。

      说明

      若收件人名称显示灰色,说明该账户没有设置邮箱,请确保收件人已设置好邮箱。

    • 可以在个人设置中绑定接收订阅任务的邮箱。具体操作如下:

      1. 鼠标悬浮至右上角的图像。

      2. 在下拉框中选择账号设置与管理

        账号绑定页面,绑定接收订阅任务的邮箱。image.png

    接收方式为钉钉/企业微信/飞书。

    • 推送至个人

      • 一次可选择多个接件人,且接件人只能是同组织下的阿里云账户。

    • 推送至群组

      • 选择推送至群组后可选择一种接收群,并支持选择自定义Webhook。image.png

      • 选择自定义webhook后需要输入webhooke地址密钥,获取钉钉群机器人Webhook地址请参见钉钉机器人渠道

      • 密钥为从自定义渠道中加签的值。image.png

    接收方式为自定义渠道。

    • 接收渠道

      选择已创建的自定义接收渠道,创建方法请参见自定义渠道image.png

    • 推送至个人

      • 一次可选择多个接件人,且接件人只能是同组织下的阿里云账户。

    • 推送至群组

      • 输入自定义渠道中的参数。image.png

    高级配置

    接收方式为邮箱时,您可以在高级配置中,配置以下参数:

    • 开始日期:设置订阅任务的起始日期。

    • 切图发送:打开切图发送,当某些邮件发送到客户端后由于图片过大被压缩时,收到邮件中的图片由多个图片无缝拼接而成,可以提升图片浏览效果。

    • 邮件图片宽度:当某些邮件发送到客户端时,插入的图片无法自适应宽度时,您可以设置插入邮件的图片宽度。

    • 发送邮箱:支持发送的邮箱为数据平台和自定义邮箱。

      如果选择自定义邮箱时,需要配置以下信息:

      • 邮箱密码:发送该订阅的邮箱账号和密码。

      • 发送服务器端口:邮箱服务器的SMTP地址和端口。

      • 邮件协议:支持SMTP协议和SMTPS协议。

      • 加密方式:支持SSLSTARTTLS两种加密方式,也支持选择不加密。

      • 验证方式选择登录验证时需要输入发送该订阅的邮箱密码昵称,选择无验证时无需输入密码。

      image.png

      说明

      仅选择接收方式邮件时,才会出现切图发送发送邮箱选项。

    接收方式为钉钉/企业微信/飞书时,您可以在高级配置中,配置以下参数:

    • 开始日期:设置订阅任务的起始日期。image.png

    接收方式为自定义渠道时,您可以在高级配置中,配置以下参数:

    • 开始日期:设置订阅任务的起始日期。

    • 回传参数:回传参数内可配置参数名、参数值等自定义信息,最多可添加5条参数image.png

  4. 单击确定,保存订阅任务配置。

按任务接收人权限创建

  1. 登录Quick BI控制台,点击顶部导航栏的企业应用图标(image)并选择订阅管理

    image

  2. 订阅管理页面的订阅任务页签下,单击+ 新建订阅任务

    image

  3. 新建任务弹窗中,将当前订阅任务的数据权限选择为接收人,其余配置项按实际需求配置即可,具体配置说明同按任务负责人权限创建 > 步骤3image

    Quick BI会根据接收人的行列权限等因素自动进行分组,并针对每种权限组合分别执行查询、生成截图并推送。 因此,即使多个接收人订阅的是同一份报表,也会因各自的数据权限不同,看到差异化的报表内容。

    说明
    • 配额限制:每个组织最多支持创建10个该类型的订阅任务,每个任务支持的最大权限组合数为30个。如需扩展配额,请联系运营团队咨询独享资源。

    • 推送限制

      • 由于该功能涉及复杂的权限计算与截图渲染,系统负载较高,任务执行可能存在1-2小时的延迟。因此,暂不支持设置“小时”级的订阅频率。

      • 仅支持个人渠道推送,不支持推送至OA群组、自定义渠道。

      • 若接收人暂无报表查看权限,系统将自动过滤该用户,不再向其推送订阅内容。

  4. 配置完成后点击确定,系统将在保存任务时自动校验接收人的权限组合数,并通过弹窗的方式提示。

    • 当权限组合数未超过上限30时,点击知道了即可保存任务。

      image

    • 当权限组合数超过上限30时,不支持保存当前任务,您需要重新调整接收人范围。image

  5. 任务保存成功后即会自动开启。若后续用户/用户组权限类型变化,导致权限组合数超过30,将导致订阅任务暂停,且任务负责人会收到异常通知。image任务负责人接到异常通知后,可登录订阅管理页面,找到异常任务并按下图指引查看其日志。image在执行任务时,系统会按照接收人行列权限将当前任务拆分为多个子任务,当前日志界面中展示的是任务整体的运行情况,您可以通过点击详情,进一步查看各个子任务的运行日志。111

后续步骤

创建完成后,您还可以管理订阅任务和查看订阅任务发送记录,请参见管理订阅任务管理发送记录