API Configuration

  • Last update:  2023-08-31
  • Overview

    Version

    Report Server Version

    Plugin Version

    11.0.9

    1.6.1

    Application Scenarios

    Only E-mail, Message, Platform Notification, and part of Client Notification are supported in early versions of Data Alert plugin. However, complex alert-receiving scenarios are often encountered in practical applications and most companies have their own OA or dedicated notification platforms. To meet the timeliness of alert notifications and better conform to users' notification-receiving habits, Data Alert plugin allows customizing platforms or apps for notifications through an open interface, improving the effectiveness of data alerts.

    Setting Method

    You need to install Data Alert plugin and configure relevant permissions first. For details, see Introduction to Data Alert Plugin.

    Where to Set

    Log in to the decision-making platform as the super admin, choose System Management > Data Alert, click the setting icon to go to the Third-Party Alert App page, and click Add App to start the configuration.

     1.png

    Setting Page

    Fill in the following configuration items according to the actual situation, as shown in the table below.

     2.png

    Configuration Item

    Required or Not

    Explanation

    App Name

    Required

    Allows customizing the app name.

    App Description

    Not required

    Allows customizing the app description.

    App Status

    Required

    Mandatory single selection with two options: Enable (set by default) and Disable

    • Enable: If you select Client Notification when creating an alert task, the app name will be selectable on the push terminals.

    • Disable: If you select Client Notification when creating an alert task, the app name will not appear on the push terminals.

    Request Address URL

    Required

    Allows customizing the request address URL.

    Request Method

    Required

    Mandatory single selection with two options: POST (set by default) and GET

    Request Header

    Required

    Enters the corresponding key and value.

    • Click Add to add key-value pairs in the request header.

    • Click the deletion icon to delete the edited key-value pairs (retain at least one pair).

    Some APIs require specific headers to be sent with the request to provide more metadata about the operation being performed. You can set them here by entering any key-value pairs you need.

    Request Body

    Required

    Allows customizing input. The content (only in JSON, XML, and TXT formats) entered in the body will be sent to the push terminals as the notification body when the alert is triggered. The supported parameters are as follows:

    • Triggered time: ${triggeredTime} (in yyyy-MM-dd HH:mm:ss format)

    • Alert name: ${taskName}

    • Template where the abnormal data is located: ${templatePath}

    • Access address: ${targetLink} (platform address like webroot/decision/view/report?viewlet=GettingStarted.cpt)

    • Triggering condition: ${ruleDescription} (configured condition description)

    • Receiver: ${receiveUsers} (concatenate strings of receivers with a half-width comma (,))

    • Number of values that meet the condition: ${ruleMatchDataCount}

    • Maximum value that meets the condition: ${ruleMatchDataMax}

    • Minimum value that meets the condition: ${ruleMatchDataMin}

    • Getting the notification content of the alert creation page: ${notifyContent}

    iconNote:

     If the ${notifyContent} parameter is added in Request Body, the actual content received in the app after the alert task is created = the request body filled in the app page + the notification content on the alert creation page.

    If the ${notifyContent} parameter is not added, the actual content received in the app = the request body filled in the app page.

    Setting an Alert Task

    After the super admin completes the app configuration, users with data alert permissions can select API Notification under Alert Notification > Notification Method.

    For details about basic settings, see Creating an Alert Task.

    Tick API Notification under Alert Notification > Notification Method to select the corresponding app.

     3.png

    Demonstration

    Super admin enters necessary notification content in Request Body on the app configuration page and users customize the notification content in Alert Notification to make the content more flexible.

    4.png

    Attachment List


    Theme: Report Application
    • Helpful
    • Not helpful
    • Only read

    滑鼠選中內容,快速回饋問題

    滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。

    不再提示

    10s後關閉

    Get
    Help
    Online Support
    Professional technical support is provided to quickly help you solve problems.
    Online support is available from 9:00-12:00 and 13:30-17:30 on weekdays.
    Page Feedback
    You can provide suggestions and feedback for the current web page.
    Pre-Sales Consultation
    Business Consultation
    Business: international@fanruan.com
    Support: support@fanruan.com
    Page Feedback
    *Problem Type
    Cannot be empty
    Problem Description
    0/1000
    Cannot be empty

    Submitted successfully

    Network busy