Scheduled Notification to Lark

Version

Function Overview

Server-side notifications can be pushed to individual Lark users, enabling them to keep abreast of data across different business scenarios, such as product inventory, sales progress, salary details, and late attendance.

Server-side notifications can also be pushed to Lark chatgroups, enabling real-time and collaborative data monitoring. When an anomaly occurs, group members can promptly tag the responsible personnel (@mentions) and initiate discussions directly within the group.

Function Description

Notifications can be pushed to Lark individual users and chatgroups through the configuration of the Lark Management plugin and a scheduled task.

Note: 

FineReport SSO is supported only when messages pushed to Lark are custom links.

For details about how to integrate FineReport with Lark, see Integration with Lark.

Setting a Scheduled Task

You can choose File Processing > Client Notification of the scheduled task in Task Schedule, tick Lark Notification in Push Terminal, and select the required Lark app, as shown in the following figure.

In this example, choose File Processing > Client Notification of the scheduled task in Task Schedule, tick Lark Notification in Push Terminal, select the required Lark app, set Message Type to Link Message, select Custom Link in Link, enter the link generated under Lark Management > App Quick Configuration > Lark Link Generation, and enter the content in Theme.

Note: Supported push message types include Link Message (custom links only), Image/Text Message, and File Message. Image Message is additionally supported in the plugin of V11.0.74 and later versions.

The following figure shows the specific setting items.

Effect Display

You can view notifications pushed by the bot in Lark, as shown in the following figure.

Configuring the Integration with Lark

For details, see Integration with Lark.

Creating a Lark Chatgroup

In Lark Management, choose App Quick Configuration > Lark Chatgroup, click New Lark Chatgroup, enter the information in the pop-up New Lark Chatgroup window, and click Yes. In this way, the notifications can be pushed to Lark chatgroups. The chatgroup must contain at least two members besides the group owner.

Setting a Scheduled Task

In File Processing of the scheduled task in Task Schedule, select Client Notification, tick Lark Notification in Push Terminal, select the app where the Lark chatgroup is created, and select the target Lark chatgroup, as shown in the following figure.

Note: Supported push message types include Link Message (custom links only), Image/Text Message, and File Message. Image Message is additionally supported in the plugin of V11.0.74 and later versions.

Note: 

1. File messages cannot be pushed to Lark chatgroups and will be automatically converted to link messages for pushing.

2. If Lark Chatgroup is ticked but no chatgroup is selected, notifications cannot be pushed to the chatgroup.

3. Default User Group is a mandatory option ticked by default in Recipient. If you are not in the chatgroup but belong to the default user group, you will still receive the Lark notifications individually.

In this example, choose File Processing > Client Notification of the scheduled task in Task Schedule, tick Lark Notification in Push Terminal, select the required Lark app, set Message Type to Link Message, select Custom Link in Link, enter the link generated under Lark Management > App Quick Configuration > Lark Link Generation, and enter the content in Theme.

The following figure shows the specific setting items.

Effect Display

Different configurations under Client Notification > Message Type may impact the SSO function.

Note: 

FineReport SSO is supported only when messages pushed to Lark are custom links.

Link Message

Custom Link

The custom links support the following three types of URL:

1. Relative template path

For example, /webroot/decision/view/report?viewlet=GettingStarted.cpt

FineReport SSO is not supported for links of this type. You must manually enter the username and password to access the template.

2. Template preview link

For example, http://192.168.100.1:8080/webroot/decision/view/report?viewlet=GettingStarted.cpt

FineReport SSO is not supported for links of this type. You must manually enter the username and password to access the template.

3. Link generated in Lark Management

For example,https://open.feishu.cn/open-apis/authen/v1/index?redirect_uri=http%3A%2F%2Fsecure.finedevelop.com%3A55082%2Fwebroot%2Fdecision%2Fplugin%2Fpublic%2Fcom.fr.plugin.feishu.v11%2Ffeishu%2Fsingle%2Flogin%3Fsb%3D2FEC702A8D29D9B879491FEEFA2A8AF0%26terminal%3DH5%26__device__%3DiPhone%26deviceType%3DiPhone%26redirectUrl%3D6DFF803D37F20116A96A83863D08A23B&app_id=cli_a1debcb364b8900b&state=STATE

For details, see the "Lark URL Generation" section in Integration with Lark. FineReport SSO is supported for links of this type.

Times Result Link

FineReport SSO is not supported for Timed Result Link. You must manually enter the username and password to access the template.

Image/Text Message

Only when you set Link to Custom Link and enter the link generated in Lark Management as a custom link, FineReport SSO is supported.

File Message

FineReport SSO is supported.